home *** CD-ROM | disk | FTP | other *** search
/ Enigma Amiga Life 110 / EnigmaAmiga110CD.iso / kit internet / utility / amirc_34 / documentation / amirc.doc next >
Text File  |  2000-01-01  |  141KB  |  4,996 lines
  1.  
  2.  
  3. AmIRC 3.4 Guide - Table Of Content
  4. **********************************
  5.  
  6. Welcome to AmIRC, the AmigaOS IRC client (Version 3.4).
  7.  
  8. Thank you for reading this manual as it will help you make the most out
  9. of AmIRC and IRC in general. It will also prevent you from making a
  10. fool of yourself by asking silly question during your first IRC
  11. sessions.
  12.  
  13. Please don't forget to also read the Readme file included in the
  14. distribution archive as this will contain any last minute info that
  15. might be important to you!
  16.  
  17. To help you find what you want in this manual we've provided you with
  18. the following table of content. Feel free to jump directly to the
  19. chapter of your choice or you can also just browse through them.
  20.  
  21. About AmIRC
  22. ***********
  23.  
  24. In short, AmIRC is the most versatile IRC client for the Amiga
  25. computer. It allows you to chat to other users worldwide over the
  26. internet using IRC.
  27.  
  28. IRC stands for Internet Relay Chat, originally written by Jarkko
  29. Oikarinen <jto@tolsun.oulu.fi>. In a nutshell, IRC consists of a network
  30. of computers (servers) that are connected to each other via the
  31. internet or a LAN, and allow users with proper client software to
  32. connect and chat with each other. Within this network, virtual space is
  33. divided up into channels, usually with a topic of conversation, where
  34. users can talk in groups.  During your ventures on IRC you will notice
  35. there are a lot of special expressions and abbreviations. Make sure you
  36. have a look at the list of commonly used IRC Terms and expressions in
  37. this guide.
  38.  
  39. IRC used to be a technical matter with the user having to type in
  40. commands to connect to a network and to send message to a specific
  41. channel.  AmIRC takes care of the technical part with a comfortable
  42. user interface without compromising on flexibility.
  43.  
  44. Over the last years AmIRC has been constantly improved and updated. The
  45. already long list of Features was constantly growing resulting in the
  46. current version 3.4 with the following What's new?.
  47.  
  48. What's new?
  49. ***********
  50.  
  51. New since last release:
  52. -----------------------
  53.  
  54.    * The Configuration window has been re-arranged and features some
  55.      new options.
  56.  
  57.    * AmIRC now handles inline channelnames which means that if a
  58.      channelname appears in the channel you can now double click it to
  59.      enter the actual channel.
  60.  
  61.    * AmIRC's Pages mode features "Tabs" at the top of the through
  62.      which you can access the corresponding channel. Page mode also
  63.      fully suppports drag & drop to attach and detach chats to the main
  64.      window.
  65.  
  66.    * The CLEAR command allows you to easily clear any buffer.
  67.  
  68.    * The FAKE command allows you to fake servermessages that will be
  69.      processed by AmIRC.
  70.  
  71.    * New Conference Mode will suppress Join and Part messages in the
  72.      channel window.
  73.  
  74.    * You can now load/unload Plugins from within AmIRC using
  75.      LOAD,RELOAD and UNLOAD.
  76.  
  77.    * If you use a name for a Log File that already exists, AmIRC will
  78.      now ask if you want to "Append" to it or "Overwrite" it.
  79.  
  80.    * The QUERY command now uniconifies a Query window if it is issued
  81.      with a nick that is attached to an iconified Query window. You can
  82.      disable the Query windows from opening when you are away.
  83.  
  84.    * The Tray window now has a Context Menu (Right Mouse Button menu)
  85.      through which it can be snapshot, brought to the front or back and
  86.      closed.
  87.  
  88. Other recently added features:
  89. ------------------------------
  90.  
  91.    * From Version 3.0 AmIRC needs a New Keyfile! You will need to
  92.      upgrade to be able to use this new version to the fullest.
  93.  
  94.    * You can now open and close a window by double clicking on its
  95.      button in the Tray Window.
  96.  
  97.    * AmIRC now supports Mousewheel scrolling.
  98.  
  99.    * The Setup window is now layout in MUI Prefs style.
  100.  
  101.    * New RECONNECT command allows easily reconnecting to a server.
  102.  
  103.    * Added IRCNet commands for EXCADDand INVADD.
  104.  
  105.    * Channel name gadget now has a Context Menu which makes CYCLE or
  106.      LEAVE a channel only a right mouse button click away.
  107.  
  108.    * The Userlist counter now shows number of users & channel
  109.      operators. When channel has a user limit it will become a gauge
  110.      showing the channel filling.
  111.  
  112.    * Channel window and logs now have a (configurable) timestamp.
  113.  
  114.    * Any URL sent to the channel will now be underlined and
  115.      clickable, giving direct access to them. The URL Grabber will get
  116.      them too for later reference. AmIRC now also recognizes URLs that
  117.      aren't preceded with http:// and FTP URLs.
  118.  
  119.    * AmIRC will ask for a Browser if none can be found using either
  120.      OpenURL.library, Sendbrowser.amirx or Voyager IPC.
  121.  
  122.    * AmIRC will now look for the ENV Variables REALNAME and USER
  123.      upon start-up and use those if available.
  124.  
  125.    * AmIRC now supports COLOURCODES, which means it will show
  126.      individual message colours set by the sender! Rest assured this
  127.      feature can be switched off! :) (Use at own risk ;-)
  128.  
  129.    * The Channel Limit and Keyword fields are switched between text
  130.      and string object according to the user's status. i.e. When the
  131.      user is not allowed to change them, he cannot access them.
  132.  
  133.    * The Channel Limit and Keyword fields are hidden when not the
  134.      modes are not active on a channel.
  135.  
  136.    * The Topic is now a text field as long as the user is not a OP
  137.      and the channel has MODE, as the user is not allowed to change the
  138.      TOPIC anyway.
  139.  
  140.    * When MUI Bubble Help is active, the TOPIC window now comes up with
  141.      a bubble containing the user who set it and when, as well as the
  142.      complete topic string.
  143.  
  144.    * The Text Input Gadgets now have a popup menu when the right
  145.      mouse button is pressed when the mouse is on them.
  146.  
  147.    * With the new Terminal Login Mode AmIRC will open a mini 'telnet'
  148.      connection window after the initial server connection. This allows
  149.      you to bypass any firewalls, use relays etc.  (This mode is
  150.      activated by starting AmIRC from the shell using: "AmIRC
  151.      TerminalMode" or "AmIRC TM").
  152.  
  153.    * New Single Channel Window mode allows to join multiple channels
  154.      in a single window.
  155.  
  156.    * Total Queueing. Now everything which isn't urgent (like KICKs or
  157.      MODE changes) is sent through the output queue to reduce risk of
  158.      being kicked by a server due to flooding.
  159.  
  160.    * INFO Window has an additional Levelmeter which shows the number
  161.      of unsent messages in the output queue.
  162.  
  163.    * AmIRC now also supports Contact Manager and can parse URLs from
  164.      the URL Grabber to it.
  165.  
  166.    * The Scrollback Buffer can now be limited in size via Prefs.
  167.  
  168.    * Number of Query Windows can be limited.
  169.  
  170.    * AmIRC will now use OpenURL.library, if found, to send the URL to
  171.      the browser.
  172.  
  173.    * AmIRC uses Vapor Update Library to check for new versions upon
  174.      start-up. When a new version is available it can then be
  175.      downloaded automatically.
  176.  
  177.    * You can now Ban Multiple users at once by multi-selecting them.
  178.  
  179.    * Invitations are now shown in an separate Invite requester. The
  180.      requester can be disabled from the new 'Windows' section in the
  181.      preferences.
  182.  
  183.    * The Lag-O-Meter permanently monitors and shows lag as a
  184.      three-colour bar underneath the user list. Clicking on the
  185.      Lag-O-Meter opens the Information window, which has a graphical
  186.      representation of the current lag, as well as the server name,
  187.      current lag, last two lag probes and the average lag.
  188.  
  189.    * Frequently used channels can be stored in a Favorite Channels
  190.      window from where you can join them by double-clicking on them.
  191.  
  192.    * The new Tray window contains a button for every AmIRC window.
  193.      Windows can be closed individually by clicking on their 'Hide'
  194.      gadget. The Tray window shows number of messages in a window and
  195.      indicates new messages after iconification. (Requires MUI v3.8+)
  196.  
  197.    * Dialog windows have a Rename button to change the nick for the
  198.      window. Useful when someone re-enters IRC with a different nick.
  199.  
  200.    * Dialog and Channel windows have an [L] button to enable logging
  201.      of that window to a file.
  202.  
  203.    * AmIRC now uses NList.mcc for it's listviews if found. (Not used
  204.      with OS2.x)
  205.  
  206.    * DCC windows now have a Cleanup button to delete all finished or
  207.      aborted transfers at once.
  208.  
  209.    * The /BACK command resets the AWAY state no matter what it is.
  210.  
  211.    * DCC Receive window has a Replace button to overwrite existing
  212.      files.
  213.  
  214.    * DCC Receive window has a MIMEPrefs button to call up the
  215.      MIMEPrefs program.
  216.  
  217.    * The Auto accept DCC send? menu item allows to start incoming DCC
  218.      send requests without the need for confirmation.
  219.  
  220.    * Files received via DCC are opened in shared mode during transfer,
  221.      allowing you to play or view them partially while downloading.
  222.      (Especially for all you MP3 freaks out there:-)
  223.  
  224.    * AmIRC now uses MIMEPrefs for viewing files.
  225.  
  226.    * AmIRC now has an Plugin API, expect many separately developed
  227.      extension modules.
  228.  
  229.    * The Server list is now divided into Server Groups to allow
  230.      better organization of different servers of a network.
  231.  
  232.    * The Prefs menu has a new Windows section where can be determined
  233.      which windows will open on start-up.
  234.  
  235. Features
  236. ********
  237.  
  238.    * Runs with Genesis, AmiTCP, Miami and AS225 without additional
  239.      support libraries.
  240.  
  241.    * Built-in highly optimized DCC drivers for SEND, TSEND and MOVE,
  242.      with asynchronous file I/O and threaded network handling. Supports
  243.      Drag&Drop sending of files and DCC.
  244.  
  245.    * Transparent implementation of DCC routing all MSGs automatically
  246.      via DCC CHAT if applicable, to save runtime and reduce IRC load.
  247.      Option to automatically accept DCC CHAT connections.
  248.  
  249.    * Ultra fast text output and scrolling. Supports Cut&Paste for the
  250.      list text. Supports proportional fonts.
  251.  
  252.    * Internal CTCP flood and DCC bomb protection.
  253.  
  254.    * Full support of the 'Undernet' IRC extensions, both reply codes and
  255.      additional IRC commands.
  256.  
  257.    * Intuitive channel display with user list and channel mode overview.
  258.      Channel modes can easily be changed via gadgets. Configurable user
  259.      action list to perform whatever action you like on users in channel
  260.      by the press of a mouse button.
  261.  
  262.    * Supports QUERY windows for private chat.
  263.  
  264.    * Supports 'smart' banning.
  265.  
  266.    * Versatile ARexx port including server message parsing ("event
  267.      trapping") and commandline/script interaction.
  268.  
  269.    * Easy command line aliasing.
  270.  
  271.    * Built-in IdentD (automatically disabled if another IdentD is
  272.      already installed).
  273.  
  274.    * Supports nick notification, highlighting, ignoring, and kickban.
  275.  
  276.    * Versatile event handling allows you to bind sound effects,
  277.      auto-deiconify or rexx scripts to certain events.
  278.  
  279.    * Server phone book.
  280.  
  281.    * Last nick history stores the nicknames of the last nicks you've
  282.      send MSGs to, received MSGs from or addressed publicly with
  283.      'nick:'.  Reference can be used in all commands which require nick
  284.      names, e.g.  MSG, OP, DEOP. Automatic nick expansion on public
  285.      messages with ':'.
  286.  
  287.    * TAB messaging to automatically cycle the list of last used
  288.      nicknames with a MSG prefix.
  289.  
  290.    * Auto rejoin channel on KICK and auto reconnect to server facility.
  291.  
  292.    * Auto AWAY after a user-specified idle time-out. Also, auto unaway
  293.      after sending public and/or private msgs.
  294.  
  295.    * Auto update download.  Check for and download new releases with a
  296.      simple click.
  297.  
  298.    * URL grabber for interfacing with a web browser. (Using
  299.      OpenURL.library or ARexx)
  300.  
  301.    * Support for DALnet extensions.
  302.  
  303.    * AmIRC is fully localized thanks to ATO
  304.      (http://ato.vapor.com/ato).
  305.  
  306. Requirements
  307. ************
  308.  
  309. What is needed to use AmIRC?
  310. ============================
  311.  
  312. Hardware
  313. --------
  314.  
  315. AmIRC was written for the Amiga family of computers, and has been
  316. tested on Amiga 500, 1000, 1200, 2000, 3000, & 4000 computers in various
  317. configurations.
  318.  
  319. Software
  320. --------
  321.  
  322. AmIRC requires MUI V3.6 or later in order to run.
  323.  
  324. AmIRC requires KickStart & WorkBench 2.x or later, with setpatch 40.16
  325. installed.
  326.  
  327. AmIRC020 requires a 68020 or higher CPU and OS3.0 or newer. This
  328. version is optimized for such machines.
  329.  
  330. If you plan to run a TCP/IP stack and AmIRC among other Internet
  331. applications you should have at least 2 megabytes of RAM.
  332.  
  333. Finally, you need to have a TCP/IP protocol stack running, such as
  334. Genesis, Miami, AmiTCP/IP or Amiga Technology's as225r2 TCP/IP protocol
  335. stack.
  336.  
  337. Copyright
  338. *********
  339.  
  340. AmIRC has been designed, developed and written by
  341.  
  342.          Oliver Wagner                     Jamie van den Berge
  343.      Landsberge 5
  344.      45549 Sprockhövel
  345.      Germany
  346.      E-Mail: <owagner@vapor.com>       E-Mail: <entity@vapor.com>
  347.      
  348.      ©1995-2000 Oliver Wagner, Jamie van den Berge
  349.      All Rights Reserved.
  350.  
  351. This document was originally written by Laurence Walton <lww@vapor.com>
  352. and modified for the 1.65 release by Oliver Wagner, including Ariel
  353. Magnum's <amagnum@ibm.net> fine ARexx guide. Updated and revised for
  354. the AmIRC v3.4 release by Frank Mosch <frank.mosch@advalvas.be>.
  355.  
  356. Installer Script ©1995-2000 Robert C. Reiswig All Rights Reserved
  357.  
  358. No part of this archive may be redistributed except with the entire
  359. contents of the original archive.
  360.  
  361. Registration
  362. ************
  363.  
  364. Registering AmIRC
  365. =================
  366.  
  367. You may use AmIRC freely for a period of up to 30 days to evaluate the
  368. package. After those 30 days, you must either register AmIRC or stop
  369. using it completely. During the trial period, AmIRC is limited to an
  370. on-line time of 30 minutes, besides that, no functions are disabled.
  371.  
  372. To register AmIRC, see the included registration utility and assorted
  373. documentation. It has all the necessary info and prices.  You can also
  374. register on-line at http://www.vapor.com/.
  375.  
  376. Use a credit card and have your keyfile in minutes!
  377.  
  378. Installation
  379. ************
  380.  
  381. How to install AmIRC
  382. ====================
  383.  
  384. It is strongly suggested that you use AmIRC's installer script. This
  385. will make sure all necessary files are in the correct place and will
  386. make sure you will have AmIRC up and running in no time.  The installer
  387. script requires that you have the Amiga installer utility (version 43.3
  388. or later).  Once you've unpacked the AmIRC archive you can start the
  389. installation by simply clicking on the install icon in the AmIRC
  390. drawer. The installation script will ask you some questions, depending
  391. on the experience level you've selected at the start, simply answer
  392. them and the installer will do the rest.
  393.  
  394. If you cannot or prefer not to use the installer utility, a manual
  395. install is relatively simple, just move the contents of the archive to a
  396. directory of your choice and it's ready to use. If you have met the
  397. Requirements for the optimized version of AmIRC, delete the AmIRC file
  398. and rename "AmIRC020" as "AmIRC".  You might want to copy the "MUI"
  399. directory of the AmIRC distribution to MUI:Libs/MUI/ to avoid version
  400. confusion.
  401.  
  402. Connecting
  403. **********
  404.  
  405. Let's have a (first) go
  406. =======================
  407.  
  408. Once you have Installation AmIRC, you can start the program from WB by
  409. clicking on its icon. After a few moments you will be presented with the
  410. Server Selection Window. You will need to enter some data into the
  411. gadgets of this window in order for AmIRC to be able to log you onto an
  412. IRC network. First and foremost you will need to think up some witty
  413. and original nickname or handle by which you will be known during your
  414. IRC session(s). Make sure you pick an original one as some networks
  415. don't allow different users sharing the same name and won't allow you
  416. to connect until you try with a name that is not being used. You can
  417. supply AmIRC with 4 nicknames which it will subsequently use to try and
  418. connect to the network. You also need to provide AmIRC some additional
  419. information like your real name (be honest here!). If your TCP/IP stack
  420. is already running an IdentD service then you won't need to provide
  421. your user name as AmIRC will get it from the stack and the IdentD
  422. gadget will be ghosted.  Now you are ready to connect AmIRC to an IRC
  423. network. Either select a network and server from the list provided or
  424. enter the details of your own favourite server.
  425.  
  426. Operation
  427. *********
  428.  
  429. Operation at a glance
  430. =====================
  431.  
  432. The main AmIRC user interface is laid out in a logical, intuitive
  433. manner, making it easy to use. Here's an overview of the main interface:
  434.  
  435.    * The main feature of the interface is the Text Listview, where
  436.      all incoming text is displayed.
  437.  
  438.    * Directly below this is the Textinput Gadget, labelled with the
  439.      nickname that you have chosen. Any text entered here will be sent
  440.      out to the IRC server.
  441.  
  442.    * Directly next to the textinput gadget is the Logging Button
  443.      marked 'L'.  Clicking on it activates the logging of that window
  444.      to a file.
  445.  
  446.    * To the right of the listview is a Scroll Gadget, which enables
  447.      you to scroll backward through the text in the listview.
  448.  
  449.    * At the top left of the listview is a the Channelname Gadget that
  450.      shows the name of the channel that you have joined.
  451.  
  452.    * To the right of the channel name, is the Topic Input/Display
  453.      Gadget, where the topic of a joined channel is displayed.  Many
  454.      channels have topic protection, which means only channel operators
  455.      can change the topic. If you can enter text in the topic bar
  456.      (either because the topic isn't protected or you are a channel
  457.      operator) you may change the topic of the channel by entering the
  458.      topic in this gadget, and hitting the 'Enter' key.
  459.  
  460.    * To the right of the topic input gadget are theChannel Mode
  461.      Buttons, which display the current modes for the joined channel.
  462.      Users with Channel Operator (Ops) status may also use these
  463.      buttons to change the current channel modes.
  464.  
  465.         - T - Topic Protection: Toggles Topic Protection on/off. If
  466.           on, the topic can be changed by Channel Operators (Ops) only.
  467.  
  468.         - N - No Messaging: Toggles Messaging on/off. If active, a
  469.           user can only write to the channel if they have joined it.
  470.  
  471.         - S - Secret: Toggles Secret mode on/off. If active, the
  472.           channel is invisible until it is joined.
  473.  
  474.         - I - Invite Only: Toggles Invite Only mode on/off. If
  475.           active, users can only join after they have been invited.
  476.  
  477.         - P - Private: Toggles Private mode on/off. If active, the
  478.           channel will be invisible in the global channel list.
  479.  
  480.         - M - Moderated: Toggles Moderated mode on/off. If active,
  481.           only channel operators (Ops) and users with 'voice' can type
  482.           to the channel.
  483.  
  484.         - L - Limit: Sets a limited number of users allowed on the
  485.           channel
  486.  
  487.         - K - Keyword: Toggles Keyword mode on/off. If active, Users
  488.           can only join the channel if they give the correct keyword.
  489.  
  490.         - B - Ban: Sets/Displays the current Bans active on the
  491.           channel
  492.  
  493.    * Below the channel mode buttons is the User Listview, which shows
  494.      a current list of users on the joined channel. Double clicking on
  495.      a users name will perform a WHOIS on that user. Clicking once on a
  496.      users name will set that user as the default to perform other
  497.      operations on, such as an operation from the configurable user
  498.      buttons. Pressing the right mouse button when on a name shows a
  499.      menu where you can select the same functions as the User Buttons
  500.      below.
  501.  
  502.    * Directly below the User Listview is the Lag-O-Meter. This meter
  503.      indicates how much lag there is on your connection. Double
  504.      clicking on it will bring up the INFO window.
  505.  
  506.    * Below the Lag-O-Meter are the User Buttons. These buttons are
  507.      configurable from the Actions window, accessible by selecting
  508.      'Setup...' from the AmIRC Settings menu.
  509.  
  510.    * You can Drag-Highlight text in the listview in order to paste it
  511.      elsewhere.  you will need some type of snap utility such as
  512.      Newedit or Powersnap in order to past the text into another
  513.      application. The text is stored in the clipboard. To paste the
  514.      text inside AmIRC you can use <right-amiga> V.
  515.  
  516.      The TAB key will cycle through the names of people that have
  517.      previously /MSG'ed you, and insert it into the textinput gadget.
  518.      Simply enter your message after the "/MSG <user> " in order to MSG
  519.      them back.
  520.  
  521.      Entering ':' first in the textinput gadget will automatically
  522.      publicly address the last person you typed to using the ':' after
  523.      their nick.
  524.  
  525. For a full explanation of all AmIRC functions and windows please check
  526. out the Reference section.
  527.  
  528. IRC Terms
  529. *********
  530.  
  531. Specific IRC vocabulary
  532. =======================
  533.  
  534. Here's a list of some commonly used terms and expressions with their
  535. respective explanation:
  536.  
  537.    * Action: CTCP Action command, executed by a ME at the beginning
  538.      of a message.
  539.  
  540.    * Ban: A channel mode set in order to prevent a user or group
  541.      of users from joining a channel.
  542.  
  543.    * Bot: Short for Robot, a Bot is a script that acts like a user,
  544.      and can execute a command upon a certain occurrence.
  545.  
  546.    * Client: Software that is written for the purpose of connecting
  547.      to a server, in this case, an IRC server.
  548.  
  549.    * Channel: A group of users on IRC. A channel will have a name
  550.      (i/e, #AmIRC), and may or may not have a topic of conversation.
  551.  
  552.    * Channel Mode: The properties of a channel that allow or
  553.      disallow certain activities. Channel Modes can only be changed or
  554.      set by Channel Operators. The available channel modes are:
  555.  
  556.         - Invite Only: If active, This mode allows users to join if
  557.           they have been invited by someone in the channel.
  558.  
  559.         - Private: If active, the channel is invisible in the
  560.           global channel list.
  561.  
  562.         - Lag: The term which is used when the connection to a server
  563.           or client is delayed.
  564.  
  565.         - Limit: If active, sets a limit on the number of users
  566.           allowed to join a channel.
  567.  
  568.         - Moderated: If active, only Channel Operators and
  569.           users with voice may type input to the channel.
  570.  
  571.         - No Messaging: If active, prevents users from sending a
  572.           message to the channel until they have joined it.
  573.  
  574.         - Secret: If active, the channel is invisible until it is
  575.           joined.
  576.  
  577.         - Topic Protection: If active, only Channel Operators may
  578.           set or change the topic of a channel.
  579.  
  580.    * Channel Operator (or OP): A user who has control over a
  581.      channel.  A user who creates a channel is given Op status,
  582.      and in turn can give it to anyone else in the channel.
  583.  
  584.    * Chat Network: A network of computers that are interconnected so
  585.      that anyone on any server in the network may chat with anyone else
  586.      on any computer in that same network.  Here's some major chat
  587.      networks:
  588.  
  589.         - ARCnet: Amiga Relay Chat Network, partially running on
  590.           Amiga servers.
  591.  
  592.         - IRCnet: Formerly part of EFnet, now split.
  593.  
  594.         - EFnet: Eris Free Network. The largest IRC network
  595.  
  596.         - DAL-Net: A different IRC network with some specialized
  597.           functions that do not appear in typical IRC networks.
  598.  
  599.         - Undernet: An alternative IRC network
  600.  
  601.    * Command: A message to an IRC server or to a local or remote
  602.      client.  Commands generally begin with a /.  See Commands.
  603.  
  604.    * CTCP: Client To Client Protocol, A standard for sending commands
  605.      from one client to another, usually for the purpose of getting
  606.      information from the remote client. See CTCP.
  607.  
  608.    * DCC: Direct Client Connection - a standard for creating a direct
  609.      link between two clients, for the purpose of sending or receiving
  610.      files, or to carry a more secure conversation. See DCC.
  611.  
  612.    * IdentD: IdentD is software that can be run on the client,
  613.      allowing an IRC server to corroborate the identity of a client.
  614.      AmIRC has an IdentD built in, and will automatically disable it if
  615.      an external IdentD is running.
  616.  
  617.    * IRC: Internet Relay Chat - Any Network of Computers that run
  618.      IRC servers for the purpose of allowing users to connect to it
  619.      using client software made for IRC.
  620.  
  621.    * Kick: The occurrence of a user being removed from a joined
  622.      channel by a channel operator.
  623.  
  624.    * Lag: Term to specify that the connection is delayed to some
  625.      extend.
  626.  
  627.    * MOTD: Message Of The Day, A message that may or may not be
  628.      updated daily, that is meant to be read when connecting to an IRC
  629.      server.
  630.  
  631.    * Netsplit: An event that occurs when a server goes down that
  632.      other servers depend on for network packets. Any servers that are
  633.      dependant on the crashed server will split from the net, that is,
  634.      they will still be up and running, with active clients, but any
  635.      clients on the other side of the crashed unit will appear to have
  636.      all logged off at once.
  637.  
  638.    * Nick: Short for Nickname, this is an alias that you may pick for
  639.      yourself.
  640.  
  641.    * Op: See Channel Operator.
  642.  
  643.    * Server: A computer that is Running IRC server software, allowing
  644.      it to be connected to by IRC clients or other servers.
  645.  
  646.    * Server Operator: A person in control of an IRC server.
  647.  
  648.    * TLA (Three Letter Abbreviations): Commonly used acronyms, not
  649.      entirely restricted to 3 letters:
  650.  
  651.         - AFAIK: As Far As I Know
  652.  
  653.         - AFK: Away From Keyboard
  654.  
  655.         - ASAP: As Soon As Possible
  656.  
  657.         - ATM: At The Moment
  658.  
  659.         - BRB: (I'll) Be Right Back
  660.  
  661.         - BBL: (I'll) Be Back Later
  662.  
  663.         - BBIAB: (I'll) Be Back In A Bit
  664.  
  665.         - BTW: By The Way
  666.  
  667.         - CU: Or Cya, See You
  668.  
  669.         - CUL: Or CUL8R, See You Later, Catch You Later
  670.  
  671.         - DL: Or D/L, Download
  672.  
  673.         - FAQ: Frequently Asked Questions
  674.  
  675.         - FWIW: For What It's Worth
  676.  
  677.         - FYI: For Your Information
  678.  
  679.         - IC: I See
  680.  
  681.         - IIRC: If I Remember Correctly
  682.  
  683.         - IMHO: In My Humble|Honest Opinion
  684.  
  685.         - L8R: Later
  686.  
  687.         - LOL: Laughs Out Loud
  688.  
  689.         - LTNS: Long Time No See
  690.  
  691.         - MOTD: Message Of The Day
  692.  
  693.         - NE1: Anyone
  694.  
  695.         - NP: No Problem
  696.  
  697.         - OTL: Out To Lunch
  698.  
  699.         - PLS: Or PLZ, Please
  700.  
  701.         - PPL: People
  702.  
  703.         - POV: Point Of View
  704.  
  705.         - RE: Welcome back, short for Regards
  706.  
  707.         - ROTFL: Rolls On The Floor Laughing
  708.  
  709.         - RSN: Real Soon Now
  710.  
  711.         - RTFM: Read The F***ing Manual
  712.  
  713.         - TIA: Thanks In Advance
  714.  
  715.         - TNX: Or Thnx, Thanks
  716.  
  717.         - TTYL: Talk To You Later
  718.  
  719.         - TTFN: Ta Ta For Now
  720.  
  721.         - UL: Or U/L, Upload
  722.  
  723.         - WB: Welcome Back
  724.  
  725.         - WTF: What(Why) The F***
  726.  
  727.    * Topic: A heading for a channel that may or may not have
  728.      anything to do with the conversation at hand.
  729.  
  730.    * User: A person using an IRC Client to connect to a server to
  731.      chat.
  732.  
  733.    * User Mode: Settings that affect a users properties.
  734.  
  735.         - Invisible: If this mode is set, a user will be invisible
  736.           in the global user list. The user will still be visible in
  737.           the user list of any joined channel, however.
  738.  
  739.         - Wallops: When set, this mode will allow receiving of
  740.           messages from the server operator to all operators.
  741.  
  742.    * Userhost: This is the string that defines a user.  It consists
  743.      of the user's chosen nick, login name and domain name.  For
  744.      example:
  745.      Wupper!jwupper@monorail.denet234.de
  746.      |      |       |        |      |_ Domain
  747.      |      |       |        |________ Network
  748.      |      |       |_________________ Machine
  749.      |      |_________________________ Login
  750.      |________________________________ Nick
  751.    * Voice: Status a normal (not an operator) user must have to type
  752.      into a moderated channel.
  753.  
  754. Menus
  755. *****
  756.  
  757. What's on the menu?
  758. ===================
  759.  
  760. Menus
  761. =====
  762.  
  763. AmIRC Menu
  764. ----------
  765.  
  766. Select Server...
  767.      Opens the server window from which you can select various options
  768.      for connecting to an IRC server. See Connecting.
  769.  
  770. Reconnect
  771.      Reconnects to the previously selected server, without having to
  772.      open de server window.
  773.  
  774. Disconnect
  775.      Disconnects you from the current server without having to quit
  776.      AmIRC.
  777.  
  778. Logging Enabled?
  779.      Toggles logging on/off.
  780.  
  781. Iconify
  782.      Hides the AmIRC window either in an icon on the Workbench screen
  783.      or in the WB Tools menu (selectable in MUI Prefs).
  784.  
  785. Help...
  786.      Opens Amirc.guide for reference while using AmIRC.
  787.  
  788. About AmIRC...
  789.      Opens a window with information about AmIRC and its Developer.
  790.      Here you may connect to the AmIRC home page if your browser is
  791.      running.
  792.  
  793. About MUI...
  794.      This will open a small window that displays information about the
  795.      current version of MUI that is installed on your system, also,
  796.      this window provides the option to register or update your MUI
  797.      software.
  798.  
  799. Quit
  800.      Will close the current instance of AmIRC, leaving other instances
  801.      open.
  802.  
  803. Menus
  804. =====
  805.  
  806. Windows Menu
  807. ------------
  808.  
  809. Channel Windows
  810.      If more than one AmIRC window is opened, you may select one here
  811.      to pop it to front.
  812.  
  813. Dialog Windows
  814.      If any dialogue windows are open, you may select one here and
  815.      bring it to front.
  816.  
  817. Windows List...
  818.      Shows the tray window where all windows are represented by a
  819.      button. Hidden windows can be opened by double-clicking that
  820.      window's button.
  821.  
  822. Channel List Window...
  823.      This will produce a window where you may list channels by min.
  824.      users, pattern matching, or both. Once listed, you may list users
  825.      on a channel or join it by double-clicking the channel name or
  826.      selecting 'join channel' gadget.  Please note that this function
  827.      can cause a high load of traffic and may take a while on slow
  828.      (14.4 or less) connections.
  829.  
  830. Notify Window...
  831.      In the Notify window you may enter nicks of users that you wish to
  832.      be notified of their entering/leaving IRC. The 'check period' is
  833.      how often AmIRC will check for the specified users. Add a nick to
  834.      the list by clicking in the input text gadget, and typing in the
  835.      nick. Delete a nick by clicking on it's entry and then click on
  836.      'Delete nick' gadget.
  837.  
  838. Favorite Channels...
  839.      In the Favorite Channels window you can make a list of all your
  840.      favourite channels allowing you to join them with a simple double
  841.      mouse-click.
  842.  
  843. DCC-Send Window...
  844.      Brings up the DCC-Send window where you can specify a user and a
  845.      file to send to them. This window will also be opened
  846.      automatically when using the 'DCC send' userbutton on the
  847.      interface. 'Send Path' is the path (and filename) that will be sent
  848.      to the user. Enter the name of the user in the textinput gadget at
  849.      the bottom of the window. The cycle gadget next to the 'Nick'
  850.      gadget selects either 'DCC Send' or 'DCC Move' protocols. See DCC
  851.      section for details about these protocols.  The 'Reoffer' button
  852.      allows you to reoffer a (failed) file to the user. The 'Remove Job'
  853.      button will remove a complete transfer or if not complete, one
  854.      click will abort the send and the second click will remove it.
  855.      Finally, the 'Cleanup' button removes all finished or aborted
  856.      transfers from the window.
  857.  
  858. DCC-Receive Window...
  859.      The DCC-Receive window is very similar to the DCC-Send window.
  860.      This window will appear automatically on receiving a DCC request.
  861.      The files will be downloaded to the path entered in the 'Receive
  862.      Path' field. After a valid path is entered, click on an entry to
  863.      receive, then click the 'Get' gadget at the bottom. You can also
  864.      start the transfer by double-clicking on the entry or enabling
  865.      'Auto accept DCC send requests' in the User Modes menu.  If you
  866.      are trying to receive after a failed send, you may use the
  867.      'Resume' button instead of 'Get'. This will attempt to start
  868.      transfer where it left off. If you wish to rename the incoming
  869.      file for whatever reason, you may use the 'Rename' button.  The
  870.      'Replace' button will cause the received file to replace any
  871.      present versions.  'Remove Job' will abort an incoming file and
  872.      remove a completed or aborted file.  'Cleanup' removes all
  873.      finished or aborted transfers. See DCC.
  874.  
  875. DCC-Chat Window...
  876.      In the DCC-Chat window you can confirm a DCC chat connection from
  877.      another user.  Simply select the client sending the request and
  878.      click on 'Open' to make the connection.  You can close the
  879.      connections using 'Close'. 'Cleanup' removes all closed DCC chat
  880.      connections. See DCC.
  881.  
  882. Raw Log Window...
  883.      The Raw Log window can be used to view the raw IRC messages as
  884.      they appear before AmIRC formats them for easy reading in the
  885.      AmIRC listview.  Here you may also clear the log, and select when
  886.      the log is active: 'Never', 'Only if window open', or 'Always'.
  887.      The log Listview shows the USERHOST, Type of message, Channel
  888.      Name, and message, in that order.
  889.  
  890. URL Grabber Window...
  891.      Any WWW URL AmIRC recognizes it will place in the URL Grabber
  892.      window. From here you can select them and either send them to your
  893.      browser or the clipboard. You can also clear the list.
  894.  
  895. Private Msgs Window...
  896.      The Private Messages window holds a history of private messages
  897.      sent to you, which you can later reference or review. You can of
  898.      course clear the list.
  899.  
  900. Info Message Window
  901.      The Info Messages window displays server messages, wallops
  902.      messages, and CTCP requests.  Any 'Shanghai' gadgets that are
  903.      activated will prevent that type of message from showing in the
  904.      main channel window, even when the info window is closed.  The
  905.      lower part of the window shows AmIRC's Lag-O-Meter. The VU style
  906.      meter is a graphical representation of the current lag to the
  907.      server. Next to the meter is the name of the server. Also shown
  908.      are the current lag, last two probes and the average of the last
  909.      two lags.
  910.  
  911. Flush Buffer
  912.      This item will clear the history of the main AmIRC listview.
  913.  
  914. Save Buffer...
  915.      This item allows you to select a filename to save the history
  916.      buffer to disk.
  917.  
  918. Menus
  919. =====
  920.  
  921. User Modes Menu
  922. ---------------
  923.  
  924. Invisible?
  925.      Toggles wether you're invisible in the global userlist or not. See
  926.      IRC Terms.
  927.  
  928. Receive Wallops?
  929.      Toggles wether you will receive messages to all operators or not.
  930.      See IRC Terms.
  931.  
  932. Receive Server Notices?
  933.      Toggles wether you receive server notices or not.
  934.  
  935. Marked AWAY?
  936.      Marks you are AWAY.
  937.  
  938. Auto rejoin on KICK?
  939.      If set, will automatically attempt to reconnect you to a channel
  940.      you have been kicked from. Note that if a ban was set with the
  941.      kick, you will not be able to rejoin.
  942.  
  943. Auto reconnect to server?
  944.      If set, this will automatically attempt to reconnect you to the
  945.      server if you are disconnected for any reason.
  946.  
  947. Clone detection
  948.      Detect wether clones are present.
  949.  
  950. Oper detection
  951.      Detect IRC Operators.
  952.  
  953. Auto open Dialog Windows?
  954.      If set, will automatically open chat window upon receipt of a MSG
  955.      or DCC request.
  956.  
  957. Auto accept DCC chat requests?
  958.      If set, this will automatically accept DCC chat requests.  It will
  959.      not open a chat window for you, however. Do this by opening the
  960.      DCC chat window in the Windows menu.
  961.  
  962. Auto accept DCC send requests?
  963.      If set, this will automatically accept DCC send requests, so
  964.      downloading will start immediately.
  965.  
  966. Do BEEPs?
  967.      If set, AmIRC will send audio beeps (or samples, if configured in
  968.      the Events page of the settings requester) for certain events.
  969.  
  970. Play CTCP SOUND requests?
  971.      If checked, AmIRC will acknowledge and play CTCP sound requests,
  972.      if this is configured properly.
  973.  
  974. Do Color codes?
  975.      Here you can enable the (in)famous COLOURCODES.
  976.  
  977. Menus
  978. =====
  979.  
  980. Settings Menu
  981. -------------
  982.  
  983. Setup...
  984.      Calls the AmIRC Setup, allowing you to change the many settings of
  985.      AmIRC to suit your needs.
  986.  
  987. MIMEPrefs...
  988.      Calls the MIMEPrefs program if present in the AmIRC directory or
  989.      Prefs:. It allows you to set global MIME settings for view and
  990.      saving files.
  991.  
  992. Dialog Window Buttons?
  993.      If set, the AmIRC dialogue window will contain 4 gadgets in the
  994.      upper right corner.  These are labelled: 'Whois', 'Ping', 'DCC
  995.      Chat', & 'DCC Send'.  These gadgets will perform their respective
  996.      functions on the user that the dialogue window is opened to.
  997.  
  998. Use MIMEPrefs for viewing?
  999.      If set, AmIRC uses the global MIME settings set with the MIMEPrefs
  1000.      program to determine what program to view the received file with.
  1001.  
  1002. Use MIMEPrefs for saving?
  1003.      If set, AmIRC uses the global MIME setting set with the MIMEPrefs
  1004.      program to determine whether and where to save the received file.
  1005.  
  1006. Use pages by default?
  1007.      If set, AmIRC will only open one channel window at a time. If
  1008.      multiple channels are joined they can be accessed using the "tab"
  1009.      with the corresponding channelname at the top of the window.
  1010.  
  1011. Load Settings...
  1012.      Opens a requester allowing you to recall previously saved
  1013.      non-default AmIRC Configurations.
  1014.  
  1015. Load settings from default
  1016.      Reloads the last saved default configuration
  1017.  
  1018. Save Settings
  1019.      Saves the current configuration under the last name set in the
  1020.      'Save settings as...' menu item.  If the settings have not
  1021.      previously been named, they are saved as default.
  1022.  
  1023. Save settings as...
  1024.      Opens a requester allowing you to choose a filename to save the
  1025.      current AmIRC configuration as other than default.
  1026.  
  1027. Save as default
  1028.      Saves the current AmIRC configuration as the default start-up
  1029.      configuration.
  1030.  
  1031. Create icons?
  1032.      If Checked, will create icons for saved configuration files,
  1033.      allowing them to be selected from the Workbench.
  1034.  
  1035. Save Settings On Exit
  1036.      If checked, this item will cause AmIRC to save the current
  1037.      settings as default upon exiting the program.
  1038.  
  1039. MUI Settings...
  1040.      Opens the MUI Prefs program for altering the MUI Configurable AmIRC
  1041.      configuration.
  1042.  
  1043. Menus
  1044. =====
  1045.  
  1046. Plugins Menu
  1047. ------------
  1048.  
  1049. The Plugins menu shows a list of all installed AmIRC plugins. The
  1050. plugins are located in the Plugins directory in the AmIRC directory. It
  1051. also allows you to access any Plugin preference that may be available.
  1052.  
  1053. Menus
  1054. =====
  1055.  
  1056. Rexx Menu
  1057. ---------
  1058.  
  1059. This menu will only be present when any ARexx scripts reside in the
  1060. AmIRC/Rexx/ directory and will display them. AmIRC ARexx scripts should
  1061. be named with the .  amirx extension. From this menu you may execute
  1062. any existing AmIRC ARexx script.  See the full ARexx for an in-depth
  1063. look on ARexx.
  1064.  
  1065. Using the commands in AmIRC.
  1066. ****************************
  1067.  
  1068. Overview
  1069. ========
  1070.  
  1071. AmIRC has many built-in commands. Some of these commands are processed
  1072. locally, whereas others are sent to the IRC server.
  1073.  
  1074. Commands generally start with a '/' to differentiate them from normal
  1075. text. If you want to use the / character at the start of normal text,
  1076. use '//' instead.
  1077.  
  1078. Many commands require a channel name as a parameter. AmIRC will
  1079. automatically fill in the channel name of the current window if you
  1080. don't specify a channel name on your own.
  1081.  
  1082. For commands which require a nick name (e.g. /MSG or /OP, there
  1083. are three special short-cut arguments:
  1084.  
  1085. .
  1086.      The period is replaced with the nickname of the last person you
  1087.      have send a private message to.
  1088.  
  1089. ,
  1090.      The comma is replaced with the nickname of the last person who
  1091.      send a message to you. Be careful with this, since you might
  1092.      easily address the wrong person if someone sends you a message
  1093.      while you are still typing this command!
  1094.  
  1095. :
  1096.      The colon is replaced with the nickname of the last person which
  1097.      you have addressed with a 'Nick:' prefix inside a channel.
  1098.  
  1099. You may easily carry a dialogue with a particular user by first
  1100. clicking on their username in the user list, then any time you hit the
  1101. TAB key, the input string will be set up with '/MSG <user> ', after
  1102. which you may type in the message and hit return.  This will work after
  1103. initiating a DCC request as well. Please note that if you have
  1104. configured the user list as a separate window, you must reactivate the
  1105. message window after clicking on a username.
  1106.  
  1107. You can also use TAB to complete a nickname by typing only the first
  1108. character, pressing TAB then will cycle you through all the nicks that
  1109. start with that character.
  1110.  
  1111. When you have set an ALIAS you can force AmIRC to use the original
  1112. command by preceding the command with an exlamation mark (!).
  1113.  
  1114. Reference to all AmIRC commands
  1115. ===============================
  1116.  
  1117. Commands
  1118. ========
  1119.  
  1120. ?
  1121. -
  1122.  
  1123. Usage: /? [Command]
  1124.  
  1125. With this command you can get a list of all available commands. When a
  1126. command is added behind it, you get the correct command syntax.
  1127.  
  1128. Alternative: HELP
  1129.  
  1130. EXAMPLES:
  1131.  
  1132. /?
  1133.      Will show a list of all available commands
  1134.  
  1135. /? Ping
  1136.      Will show the correct command syntax for the PING command: Usage:
  1137.      /PING [nick]
  1138.  
  1139. Commands
  1140. ========
  1141.  
  1142. ADMIN
  1143. -----
  1144.  
  1145. Usage: /ADMIN [Server]
  1146.  
  1147. The admin message is used to find the name of the administrator of the
  1148. given server, or current server if [Server] parameter is omitted.
  1149.  
  1150. EXAMPLES:
  1151.  
  1152. /ADMIN irctest.vapor.com
  1153.      Shows the information for the server irctest.vapor.com:
  1154.               «Admin» Administrative info about irctest.vapor.com
  1155.           «Admin» Vapor's experimental ARCNet Server
  1156.           «Admin» Oliver Wagner <owagner@vapor.com>
  1157.           «Admin» Slow Mess Clients Welcome(tm)
  1158.  
  1159. Commands
  1160. ========
  1161.  
  1162. ALIAS
  1163. -----
  1164.  
  1165. Usage: /ALIAS [Alias [Replacement, %p for alias parameters]
  1166.  
  1167. With ALIAS you can make an alias for frequently used terms. You can
  1168. also add parameters needed for certain commands using %p.
  1169.  
  1170. Special Note: When you have set an alias for a command that normally
  1171. exists in AmIRC, you can force AmIRC to use the original command
  1172. instead of the alias by preceding it with an exlamation mark.
  1173.  
  1174. You can also change Aliases using the Lists.  EXAMPLES:
  1175.  
  1176. /ALIAS Goto Join %p
  1177.      You can now use: /GOTO #Test instead of /JOIN #Test
  1178.  
  1179. /!PING
  1180.      Forces AmIRC to issue the original PING command instead of an
  1181.      alias called PING.
  1182.  
  1183. Commands
  1184. ========
  1185.  
  1186. AWAY
  1187. ----
  1188.  
  1189. Usage: /AWAY [message]
  1190.  
  1191. When used with the optional [message] argument, it will mark you as
  1192. being away and send the message to any client sending a MSG to you.
  1193. Otherwise, it will remove a previously set away message.
  1194.  
  1195. Related: BACK
  1196.  
  1197. EXAMPLES:
  1198.  
  1199. /AWAY eating dinner
  1200.      Will send the message '<nick> is away: eating dinner', where
  1201.      nick is the nickname of the user that is away.
  1202.  
  1203. /AWAY
  1204.      Will remove a previously set Away Message.
  1205.  
  1206. Commands
  1207. ========
  1208.  
  1209. BACK
  1210. ----
  1211.  
  1212. Usage: /BACK (no arguments)
  1213.  
  1214. Where AWAY toggles between setting and resetting the Away state.  This
  1215. command always resets the Away state and thus no longer marks you as
  1216. away.
  1217.  
  1218. Related: AWAY
  1219.  
  1220. EXAMPLES:
  1221.  
  1222. /BACK
  1223.      Will reset the away state and no longer marks you as away.
  1224.  
  1225. Commands
  1226. ========
  1227.  
  1228. BAN
  1229. ---
  1230.  
  1231. Usage: /BAN [channel] userhost[,userhost...]
  1232.  
  1233. This command will ban everyone with the specified userhost(s) from
  1234. entering the channel. With the optional channel argument you can setup
  1235. a ban on a different channel than the one in which window the command
  1236. is executed.
  1237.  
  1238. Related: BANDEL BANLIST KICK KICKBAN QKICK QKICKBAN
  1239.  
  1240. EXAMPLES:
  1241.  
  1242. /BAN bill@*.microsoft.com
  1243.      Will prevent a user called bill in the microsoft.com domain
  1244.      from entering the channel.
  1245.  
  1246. /BAN Amiga bill@*.microsoft.com
  1247.      Will ban user bill on microsoft.com from entering #Amiga.
  1248.  
  1249. Commands
  1250. ========
  1251.  
  1252. BANDEL
  1253. ------
  1254.  
  1255. Usage: /BANDEL [channel] userhost[,userhost...]
  1256.  
  1257. Will remove a ban on the specified userhost(s) on the (optional)
  1258. channel.
  1259.  
  1260. Related: BAN BANLIST KICK KICKBAN QKICK QKICKBAN
  1261.  
  1262. EXAMPLES:
  1263.  
  1264. /BANDEL *!*@*microsoft.com
  1265.      Will remove the ban for the microsoft.com domain.
  1266.  
  1267. Commands
  1268. ========
  1269.  
  1270. BANLIST
  1271. -------
  1272.  
  1273. Usage: /BANLIST [channel] userhost[,userhost...]
  1274.  
  1275. Shows a list of bans currently active on the (specified) channel.
  1276.  
  1277. Related: BAN BANDEL KICK KICKBAN QKICK QKICKBAN
  1278.  
  1279. EXAMPLES:
  1280.  
  1281. /BANLIST
  1282.      Shows a list of all bans on the currently active channel.
  1283.  
  1284. Commands
  1285. ========
  1286.  
  1287. CHANNEL
  1288. -------
  1289.  
  1290. Usage: /CHANNEL channel[,channel[,...]] [key[,key,...]]
  1291.  
  1292. Join a channel on the IRC. If the channel doesn't exists, it is
  1293. automatically created.
  1294.  
  1295. There are two kinds of channels: Channel names starting with an
  1296. # are global channels and available on all IRC servers which
  1297. are connected to the net you are currently on. Channels which begin with
  1298. & are local to the chat server you are connected to.
  1299.  
  1300. If a channel requires a special keyword to join, you can submit this
  1301. after the channel name.
  1302.  
  1303. AmIRC will look for a channel window which isn't currently bound to a
  1304. channel. If it doesn't find one, a new window will be created and bound
  1305. to this channel.
  1306.  
  1307. Alternative: JOIN
  1308.  
  1309. Related: CYCLE LEAVE PART QUIT
  1310.  
  1311. EXAMPLES:
  1312.  
  1313. /CHANNEL #Amiga
  1314.      Join the channel #Amiga
  1315.  
  1316. /CHANNEL #Amiga,#AmIRC
  1317.      Join the channels #Amiga and #AmIRC
  1318.  
  1319. /CHANNEL #Secret Booh
  1320.      Join the channel #Secret that protected with keyword Booh.
  1321.  
  1322. Commands
  1323. ========
  1324.  
  1325. CLEAR
  1326. -----
  1327.  
  1328. Usage: /CLEAR [channel|nick]
  1329.  
  1330. With this command to can clear the buffer of a channel or Query window.
  1331. If no channel name or nick is specified the buffer of the window in
  1332. which the command was issued will be cleared.  Be warned that any text
  1333. in the buffer will be gone permanently!
  1334.  
  1335. EXAMPLES:
  1336.  
  1337. /Clear #Throat
  1338.      Will clear the buffer of the channel #Throat.
  1339.  
  1340. Commands
  1341. ========
  1342.  
  1343. COLOURCODES
  1344. -----------
  1345.  
  1346. Usage: Ctrl-C [Text Colour],[Background Colour]
  1347.  
  1348. Please note that this feature is not really a command, but it can be
  1349. used to control the colour(s) in which a (public) text appears. Both
  1350. the text and the background colour can be changed by first pressing
  1351. Ctrl^C (That's the 'Ctrl' key + the 'C' key simultaneously!). followed
  1352. by either one (for the text colour) or two values (text and
  1353. background). In most fonts Ctrl^C is displayed as a box (unknown
  1354. character). You can have multiple colour changes in a single text, all
  1355. preceded by Ctrl^C.  Here's a list of available colours and their
  1356. respective values:
  1357.  
  1358.       Value:   Colour:      RGB Values:
  1359.      
  1360.         0*     White        255 255 255
  1361.         1      Black        000 000 000
  1362.         2      Navy         000 000 139
  1363.         3      Green        000 255 000
  1364.         4      Red          255 000 000
  1365.         5      Maroon       139 000 000
  1366.         6      Purple       160 032 240
  1367.         7      Orange       255 165 000
  1368.         8      Yellow       255 255 000
  1369.         9      Lime         050 205 050
  1370.        10      Teal         128 128 128
  1371.        11      Aqua         127 255 212
  1372.        12      Blue         000 000 255
  1373.        13      Fuchsia      255 192 205
  1374.        14      Grey         190 190 190
  1375.        15      Silver       211 211 211
  1376.      
  1377.        *Please note that background colour 0 is
  1378.         the standard list background colour.
  1379.  
  1380. EXAMPLES: ([CTRL^C] indicates pressing CTRL and C simultaneously)
  1381.  
  1382. This text is [CTRL^C]4 RED.
  1383.      When this line is sent to a channel the word RED will be
  1384.      displayed in..... red.
  1385.  
  1386. I like [CTRL^C]8,1 Colours [CTRL^C]1,0 a lot.
  1387.      Here the word Colours will be Yellow on a Black background.
  1388.  
  1389. Commands
  1390. ========
  1391.  
  1392. CONNECT
  1393. -------
  1394.  
  1395. Usage: /CONNECT server [port [remote server]]
  1396.  
  1397. The CONNECT command can be used to force a server to try to establish a
  1398. new connection to another server immediately. CONNECT is a privileged
  1399. command and is available only to IRC Operators. If a [remote server] is
  1400. given then the CONNECT attempt is made by that remote server to the
  1401. given server and port.
  1402.  
  1403. EXAMPLES:
  1404.  
  1405. /CONNECT test1.irc.com
  1406.      Will connect test1.irc.com to the currently connected server
  1407.  
  1408. Commands
  1409. ========
  1410.  
  1411. CTCP
  1412. ----
  1413.  
  1414. Usage: /CTCP nick request
  1415.  
  1416. CTCP or Client To Client Protocol is a standard for sending commands
  1417. to other clients on IRC. Basically, CTCP messages are simply private
  1418. messages that include a code to alert the receiving client (not user)
  1419. to respond to the command.
  1420.  
  1421. CTCP commands are typically used to get information from the receiving
  1422. client, such as '/CTCP time', or '/CTCP version'. Even DCC sends a
  1423. request via CTCP to the receiving client, asking to initiate a direct
  1424. connection.
  1425.  
  1426. Related: ME DCC SOUND TIME QUERY VERSION
  1427.  
  1428. EXAMPLES:
  1429.  
  1430. /CTCP Franky Version
  1431.      This will return the version of Franky's client:
  1432.               «Reply» Franky VERSION AmIRC/AmigaOS 1.118 by Oliver Wagner <owagner@vapor.com> :
  1433.                   http://www.vapor.com/amirc/ : [#00000000] : This space for rent.
  1434.                   Mail <ads@vapor.com> for more info.
  1435.  
  1436. /CTCP Bert Time
  1437.      This will show the time set on Bert's machine:
  1438.               «Reply» Bert TIME Tue Jan 13 10:54:23 1998
  1439.  
  1440. Commands
  1441. ========
  1442.  
  1443. CYCLE
  1444. -----
  1445.  
  1446. Usage: /CYCLE [channel]
  1447.  
  1448. With CYCLE you can make AmIRC automatically leave and join a
  1449. (specified) channel.  This can be useful when you want to check a
  1450. changed user mode on a channel. When no channel name is given, the
  1451. currently active channel will be 'cycled'.
  1452.  
  1453. Related: CHANNEL JOIN LEAVE PART
  1454.  
  1455. EXAMPLES:
  1456.  
  1457. /CYCLE
  1458.      Will make AmIRC leave and join the currently active channel.
  1459.  
  1460. /CTCP #Amiga
  1461.      Will make AmIRC leave and join #Amiga, no matter what channel is
  1462.      active.
  1463.               «Reply» Bert TIME Tue Jan 13 10:54:23 1998
  1464.  
  1465. Commands
  1466. ========
  1467.  
  1468. DCC
  1469. ---
  1470.  
  1471. Usage: /DCC [SEND|MOVE|CHAT|SCHAT|GET|RESUME|LIST] [nick]
  1472. [parameters]    or: /DCC CLOSE [SEND|GET|CHAT|SCHAT] nick
  1473. [parameters]
  1474.  
  1475. DCC or Direct Client Connection is a protocol that IRC clients can
  1476. use to communicate directly with each other, bypassing the IRC server.
  1477. The reason for this is to form a faster, more stable and direct
  1478. connection through which users can transfer files, or send private
  1479. messages.
  1480.  
  1481. Note that AmIRC has its own set of Highly Optimized DCC protocols
  1482. built-in, and does not require external DCC utilities.
  1483.  
  1484. The most common use of DCC is for transferring files between two
  1485. clients.  The initiating client will send a message through the IRC
  1486. server, telling the receiver that a connection is requested. At this
  1487. time, the receiver will either accept or reject the offer for the
  1488. connection. If the receiver accepts the connection, the initiating
  1489. client will proceed to send the information directly to the receiver.
  1490. If the connection is refused, the initiating client will simply
  1491. time-out the attempt to connect.
  1492.  
  1493. Another use of the DCC standard is DCC chat, which, like DCC Send, will
  1494. send a CTCP request to the receiving client to set up a direct link. In
  1495. this case, however, the purpose of the link is for users to send
  1496. messages to each other. Because the messages are sent through the
  1497. direct link, and do not pass through the IRC server, this method of
  1498. sending messages is much more private than using the IRC's private
  1499. message (MSG) command.  With AmiRC, it must be noted that a DCC Chat
  1500. request will not open a dialogue window for you, instead, when DCC chat
  1501. is initiated and accepted, all privmsg's (MSG) to the receiving user
  1502. will be sent through the DCC link. If you wish to have a dialogue box
  1503. for chatting, the best way to do this is to highlight the users's name
  1504. in the userlist by clicking on it and then click on the 'Query' button
  1505. below the listview. This will open a window that has several options
  1506. within it. From here, you can PING or WHOIS the other user, or you may
  1507. initiate a 'DCC Send' or 'DCC Chat'. Starting a 'DCC Chat' from
  1508. this window will allow you to carry on a dialogue with the remote user
  1509. through the window.
  1510.  
  1511. EXAMPLES:
  1512.  
  1513. /DCC send Franky AmIRC20.lzx
  1514.      Will send a request to Franky to transfer a file called
  1515.      AmIRC20.lzx.  When Franky (auto-)accepts transfer will begin.
  1516.  
  1517. /DCC move Franky AmIRC20.lzx
  1518.      Will basically do the same as 'DCC Send' but it is capable of
  1519.      resuming an aborted or failed transfer. It looks in the receiving
  1520.      directory and if a file with the same name if found it will send a
  1521.      'DCC Resume' instead of 'DCC Send'.
  1522.  
  1523. Commands
  1524. ========
  1525.  
  1526. DESCRIBE
  1527. --------
  1528.  
  1529. Usage: /DESCRIBE nick describe-text
  1530.  
  1531. DESCRIBE is used to 'describe' something to another user.
  1532.  
  1533. Related: ME MSG
  1534.  
  1535. EXAMPLES:
  1536.  
  1537. /DESCRIBE John It is nice weather here
  1538.      Send the following text to user John:
  1539.               «Describe» <nick> It is nice weather here
  1540.      Where <nick> is your nickname.
  1541.  
  1542. Commands
  1543. ========
  1544.  
  1545. DEOP
  1546. ----
  1547.  
  1548. Usage: /DEOP [channel] nick[,nick...]
  1549.  
  1550. Will remove the Channel Operator status of one or several users. Note
  1551. that the user issuing the command needs to be Channel Operator himself.
  1552.  
  1553. Related: OP
  1554.  
  1555. EXAMPLES:
  1556.  
  1557. /DEOP Billy
  1558.      Removes Channel Operator status from a user called Billy.
  1559.  
  1560. /DEOP #Amiga Billy,John
  1561.      Removes Channel Operator status from users Billy and John on
  1562.      the channel #Amiga.
  1563.  
  1564. Commands
  1565. ========
  1566.  
  1567. EXCADD
  1568. ------
  1569.  
  1570. Usage: /EXCADD [channel] userhost[,userhost...]
  1571.  
  1572. With this (IRCNet specific!) command you can add exceptions to your BAN.
  1573. This way you can prevent a (friendly) user from being banned by you.
  1574. With the optional channel argument you can setup an exception for a
  1575. different channel than the one in which window the command is executed.
  1576.  
  1577. Related: BAN BANDEL BANLIST EXCDEL EXCLIST KICK          KICKBAN QKICK
  1578. QKICKBAN
  1579.  
  1580. EXAMPLES:
  1581.  
  1582. /EXCADD bill@*.microsoft.com
  1583.      Will add a user called bill in the microsoft.com domain to
  1584.      your ban exceptions, preventing you from banning him.
  1585.  
  1586. /EXCADD Amiga bill@*.microsoft.com
  1587.      Will prevent user bill on microsoft.com from being banned on
  1588.      #Amiga.
  1589.  
  1590. Commands
  1591. ========
  1592.  
  1593. EXCDEL
  1594. ------
  1595.  
  1596. Usage: /EXCDEL [channel] userhost[,userhost...]
  1597.  
  1598. With this (IRCNet specific!) command you can delete exceptions to your
  1599. BAN.  With the optional channel argument you can remove an exception
  1600. for a different channel than the one in which window the command is
  1601. executed.
  1602.  
  1603. Related: BAN BANDEL BANLIST EXCADD EXCLIST KICK          KICKBAN QKICK
  1604. QKICKBAN
  1605.  
  1606. EXAMPLES:
  1607.  
  1608. /EXCDEL bill@*.microsoft.com
  1609.      Removes a user called bill in the microsoft.com domain from
  1610.      your ban exceptions, allowing you from banning him again.
  1611.  
  1612. /EXCDEL Amiga bill@*.microsoft.com
  1613.      Allows you to ban user bill on microsoft.com on #Amiga again.
  1614.  
  1615. Commands
  1616. ========
  1617.  
  1618. EXCLIST
  1619. -------
  1620.  
  1621. Usage: /EXLIST [channel]
  1622.  
  1623. This (IRCNet specific!) command shows you all domains that are excluded
  1624. from your BAN.  With the optional channel argument you can view an
  1625. exceptions list for a different channel than the one in which window
  1626. the command is executed.
  1627.  
  1628. Related: BAN BANDEL BANLIST EXCADD EXCDEL KICK          KICKBAN QKICK
  1629. QKICKBAN
  1630.  
  1631. EXAMPLES:
  1632.  
  1633. /EXCLIST
  1634.      Will show a list of all userhosts that are excluded from banning
  1635.      on the currently active channel.
  1636.  
  1637. /EXCLIST Amiga
  1638.      Will show a list of all userhosts that are excluded from banning
  1639.      on #Amiga.
  1640.  
  1641. Commands
  1642. ========
  1643.  
  1644. FAKE
  1645. ----
  1646.  
  1647. Usage: /FAKE server_data
  1648.  
  1649. With this command you can fake data that a server normally sends to
  1650. AmIRC. This is mainly useful for debugging purposes when, for instance,
  1651. writing a script. This way you will be able to test AmIRC's reaction on
  1652. certain incoming data from a server.  WARNING: This command can result
  1653. in AmIRC crashing very easily when not used properly!  Do not use this
  1654. command unless you are absolutely sure what you're doing.
  1655.  
  1656. EXAMPLES:
  1657.  
  1658. /FAKE :Bill!Boss@Microsoft.com JOIN #LameOS
  1659.      Will result in AmIRC reporting that: -> Bill(Boss@Microsoft.com)
  1660.      has joined channel #LameOS
  1661.  
  1662. /FAKE :Bill PRIVMSG #LameOS Anyone got pie for me?
  1663.      Will show the following in the channel window of #LameOS: Bill |
  1664.      Anyone got pie for me?
  1665.  
  1666. Commands
  1667. ========
  1668.  
  1669. FINDHOST
  1670. --------
  1671.  
  1672. Usage: /FINDHOST [channel|ALL] userhost
  1673.  
  1674. With this command you can search for a user using a userhost pattern.
  1675. AmIRC will return all users matching the pattern on the currently
  1676. active channel. Alternatively you can specify which channel will be
  1677. searched in. With the ALL argument you can search the entire network.
  1678.  
  1679. Related: USERS USERHOST WHO
  1680.  
  1681. EXAMPLES:
  1682.  
  1683. /FINDHOST *.vapor.com
  1684.      Will list all users at the vapor.com domain on the currently
  1685.      active channel.
  1686.  
  1687. /FINDHOST #Amiga *.vapor.com
  1688.      Shows all users at the vapor.com domain on #Amiga.
  1689.  
  1690. /FINDHOST all *.com
  1691.      Shows all users at the .com domain on the network.
  1692.  
  1693. Commands
  1694. ========
  1695.  
  1696. GLINE
  1697. -----
  1698.  
  1699. Usage: /GLINE [gline]
  1700.  
  1701. GLINE returns a list of all (partial) domains that are banned from the
  1702. network.  The optional parameter is used as a mask.
  1703.  
  1704. EXAMPLES:
  1705.  
  1706. /GLINE
  1707.      Returns all domains banned from the network.
  1708.  
  1709. Commands
  1710. ========
  1711.  
  1712. HELP
  1713. ----
  1714.  
  1715. Usage: /HELP [Command]
  1716.  
  1717. With this command you can get a list of all available commands. When
  1718. the optional command parameter you get specific help about that command.
  1719.  
  1720. Alternative: ?
  1721.  
  1722. EXAMPLES:
  1723.  
  1724. /HELP
  1725.      Will show a list of all available commands
  1726.  
  1727. /HELP Ping
  1728.      Will show additional help about the PING command.
  1729.  
  1730. Commands
  1731. ========
  1732.  
  1733. HIGHLITE
  1734. --------
  1735.  
  1736. Usage: /HIGHLITE [item]
  1737.  
  1738. HIGHLITE can be used to light up certain texts. They will be shown in a
  1739. colour that's defined in the Colors.
  1740.  
  1741. You can also change Highlighting using the Lists.
  1742.  
  1743. Alternative: HILITE
  1744.  
  1745. Related: UNHIGHLITE UNHILITE
  1746.  
  1747. EXAMPLES:
  1748.  
  1749. /HIGHLITE MyName
  1750.      Whenever AmIRC encounters MyName it will be shown in the
  1751.      Hilighted colour.
  1752.  
  1753. Commands
  1754. ========
  1755.  
  1756. HILITE
  1757. ------
  1758.  
  1759. Usage: /HILITE [item]
  1760.  
  1761. HIGHLITE can be used to light up certain texts. They will be shown in a
  1762. colour that's defined in the Colors.
  1763.  
  1764. You can also change Highlighting using the Lists.  Alternative: HIGHLITE
  1765.  
  1766. Related: UNHIGHLITE UNHILITE
  1767.  
  1768. EXAMPLES:
  1769.  
  1770. /HILITE MyName
  1771.      Whenever AmIRC encounters MyName it will be shown in the
  1772.      Hilighted colour.
  1773.  
  1774. Commands
  1775. ========
  1776.  
  1777. IRCNAME
  1778. -------
  1779.  
  1780. Usage: /IRCNAME [new name]
  1781.  
  1782. IRCNAME is used to give yourself a nickname or change your current one.
  1783. If the chosen nick is already in use, you will be notified of this and
  1784. prompted for a new nick.
  1785.  
  1786. Alternative: NICK
  1787.  
  1788. EXAMPLES:
  1789.  
  1790. /IRCNAME Phalanx
  1791.      Sets your nickname to 'Phalanx'
  1792.  
  1793. Commands
  1794. ========
  1795.  
  1796. IGNORE
  1797. ------
  1798.  
  1799. Usage: /IGNORE [userhost|nick [[+|-]TEXT [+|-]PRIV [+|- -]CTCP
  1800. [+|-]ALL]]
  1801.  
  1802. IGNORE can be used to ignore messages coming from an annoying user. You
  1803. can set different levels of ignoring:
  1804.  
  1805.      text - This will block only text.
  1806.      priv - This will block all private messages.
  1807.      ctcp - You won't receive any CTCP request.
  1808.      all  - All traffic will be blocked.
  1809.  
  1810. Related: SILENCE UNIGNORE
  1811.  
  1812. EXAMPLES:
  1813.  
  1814. /IGNORE bill@user1.microsoft.com +priv
  1815.      This will ignore all PrivMsgs (MSG) sent by the offending user.
  1816.  
  1817. /IGNORE Bill -ctcp
  1818.      Removes CTCP ignores of Bill
  1819.  
  1820. Commands
  1821. ========
  1822.  
  1823. INVADD
  1824. ------
  1825.  
  1826. Usage: /INVADD [channel] userhost[,userhost...]
  1827.  
  1828. With this (IRCNet specific!) command you can add users to your
  1829. auto-invite list.  This way you automatically INVITE them to a
  1830. (specified) channel whenever they log onto IRCNet. With the optional
  1831. channel argument you can setup an auto-invite for a different channel
  1832. than the one in which window the command is executed.
  1833.  
  1834. Related: INVDEL INVLIST INVITE
  1835.  
  1836. EXAMPLES:
  1837.  
  1838. /INVADD bill@*.microsoft.com
  1839.      Will add a user called bill in the microsoft.com domain to
  1840.      your auto-invite list causing you to automatically invite him when
  1841.      he logs on.
  1842.  
  1843. /INVADD Amiga bill@*.microsoft.com
  1844.      Will make you auto-invite user bill on microsoft.com to
  1845.      #Amiga.
  1846.  
  1847. Commands
  1848. ========
  1849.  
  1850. INVDEL
  1851. ------
  1852.  
  1853. Usage: /INVDEL [channel] userhost[,userhost...]
  1854.  
  1855. With this (IRCNet specific!) command you can remove users from your
  1856. auto-invite list.  With the optional channel argument you can remove an
  1857. auto-invite for a different channel than the one in which window the
  1858. command is executed.
  1859.  
  1860. Related: INVADD INVLIST INVITE
  1861.  
  1862. EXAMPLES:
  1863.  
  1864. /INVDEL bill@*.microsoft.com
  1865.      Removes a user called bill in the microsoft.com domain from
  1866.      your auto-invite list.
  1867.  
  1868. /INVDEL Amiga bill@*.microsoft.com
  1869.      Stops you from auto-inviting user bill on microsoft.com to
  1870.      #Amiga.
  1871.  
  1872. Commands
  1873. ========
  1874.  
  1875. INVLIST
  1876. -------
  1877.  
  1878. Usage: /INVLIST [channel]
  1879.  
  1880. This (IRCNet specific!) command shows you all domains that are
  1881. automatically INVITE to the (specified) channel. With the optional
  1882. channel argument you can view the auto-invites for a specific channel.
  1883.  
  1884. Related: INVADD INVDEL INVITE
  1885.  
  1886. EXAMPLES:
  1887.  
  1888. /INVLIST
  1889.      Will show a list of all userhosts that are automatically invited
  1890.      to the currently active channel.
  1891.  
  1892. /INVLIST Amiga
  1893.      Will show a list of all userhosts that are automatically invited
  1894.      to #Amiga.
  1895.  
  1896. Commands
  1897. ========
  1898.  
  1899. INVITE
  1900. ------
  1901.  
  1902. Usage: /INVITE [channel] nick
  1903.  
  1904. Invites a user to the channel given in the argument, regardless of
  1905. wether the channel exists. If the named channel is MODE, the user
  1906. performing the command must be a channel operator for that channel. When
  1907. receiving an invitation you will be presented with a requester.
  1908.  
  1909. Related: INVADD INVDEL INVLIST
  1910.  
  1911. EXAMPLES:
  1912.  
  1913. /INVITE freddie #AmIRC
  1914.      Invites 'freddie' to join #AmIRC.
  1915.  
  1916. Commands
  1917. ========
  1918.  
  1919. INFO
  1920. ----
  1921.  
  1922. Usage: /INFO [server]
  1923.  
  1924. The INFO command is required to return information which describes the
  1925. server: its version, when it was compiled, the patch level, when it was
  1926. started, and any other miscellaneous information which may be
  1927. considered to be relevant. If no parameter is submitted the currently
  1928. connected server will be shown.
  1929.  
  1930. EXAMPLES:
  1931.  
  1932. /INFO
  1933.      Will return information about the server the user is currently
  1934.      connected to.
  1935.  
  1936. Commands
  1937. ========
  1938.  
  1939. ISON
  1940. ----
  1941.  
  1942. Usage: /ISON nick [nick [nick [...]]]
  1943.  
  1944. Quickly returns the user's nick if it is found, does nothing if it is
  1945. not.
  1946.  
  1947. Related: WHOIS WHOWAS WHO
  1948.  
  1949. EXAMPLES:
  1950.  
  1951. /ISON Kenneth
  1952.      Returns: '<ISON>Kenneth', if nick 'Kenneth' is found on the
  1953.      server.
  1954.  
  1955. Commands
  1956. ========
  1957.  
  1958. JOIN
  1959. ----
  1960.  
  1961. Usage: /JOIN channel[,channel[,...]] [key[,key[,...]]]
  1962.  
  1963. Join a channel on the IRC. If the channel doesn't exists, it is
  1964. automatically created.
  1965.  
  1966. There are two kinds of channels: Channel names starting with an
  1967. # are global channels and available on all IRC servers which
  1968. are connected to the net you are currently on. Channels which begin with
  1969. & are local to the chat server you are connected to.
  1970.  
  1971. If a channel requires a special keyword to join, you can submit this
  1972. after the channel name.
  1973.  
  1974. AmIRC will look for a channel window which isn't currently bound to a
  1975. channel. If it doesn't find one, a new window will be created and bound
  1976. to this channel.
  1977.  
  1978. Alternative: CHANNEL
  1979.  
  1980. Related: CYCLE LEAVE PART QUIT
  1981.  
  1982. EXAMPLES:
  1983.  
  1984. /JOIN #Amiga
  1985.      Join channel #Amiga
  1986.  
  1987. /JOIN #Amiga,#AmIRC
  1988.      Join channels #Amiga and #AmIRC
  1989.  
  1990. /JOIN #Secret Booh
  1991.      Join channel #Secret with keyword Booh.
  1992.  
  1993. Commands
  1994. ========
  1995.  
  1996. KICK
  1997. ----
  1998.  
  1999. Usage: /KICK [channel] nick [reason]
  2000.  
  2001. Forcibly removes a user from the named channel. The user sending the
  2002. /KICK command must be a Channel Operator of the channel. If the optional
  2003. [reason] is given, it will be shown as the reason for the kick.
  2004.  
  2005. Related: BAN BANDEL BANLIST KICKBAN QKICK QKICKBAN
  2006.  
  2007. EXAMPLES:
  2008.  
  2009. /KICK #AmIRC Freddie Take it outside!
  2010.      Forces 'Freddie' from channel #AmIRC with the reason 'Take it
  2011.      outside!'.
  2012.  
  2013. Commands
  2014. ========
  2015.  
  2016. KICKBAN
  2017. -------
  2018.  
  2019. Usage: /KICKBAN [channel] nick [reason]
  2020.  
  2021. Forcibly removes a user from the named channel and prevents him from
  2022. re-entering with a ban. The user sending the /KICKBAN command must be a
  2023. channel operator of the channel. If the optional [reason] is given, it
  2024. will be shown as the reason for the kick & ban.
  2025.  
  2026. Related: BAN BANDEL BANLIST KICK QKICK QKICKBAN
  2027.  
  2028. EXAMPLES:
  2029.  
  2030. /KICKBAN #AmIRC Freddie You dirty pirate!
  2031.      Forces 'Freddie' from channel #AmIRC with the reason 'You dirty
  2032.      pirate!' and cannot re-enter because he's banned.
  2033.  
  2034. Commands
  2035. ========
  2036.  
  2037. KILL
  2038. ----
  2039.  
  2040. Usage: Usage: /KILL nick comment
  2041.  
  2042. This command allows IRC Operators to disconnect abusive users from the
  2043. network.
  2044.  
  2045. EXAMPLES:
  2046.  
  2047. /KILL Pierat You're not wanted here!
  2048.      Disconnects user Pierat with the reason 'You're not wanted
  2049.      here!'
  2050.  
  2051. Commands
  2052. ========
  2053.  
  2054. LASTLOG
  2055. -------
  2056.  
  2057. Usage /LASTLOG [undefined]
  2058.  
  2059. Searches back through AmIRC's buffer and displays all occurrences of the
  2060. specified text.
  2061.  
  2062. EXAMPLES:
  2063.  
  2064. /LASTLOG amirc
  2065.      Searches and displays all lines from the buffer containing the
  2066.      text 'amirc'.
  2067.  
  2068. Commands
  2069. ========
  2070.  
  2071. LEAVE
  2072. -----
  2073.  
  2074. Usage: /LEAVE [Channel[,Channel[,...]]
  2075.  
  2076. Leaves a channel. If you don't give a channel name as a parameter, the
  2077. channel currently bound to the window in which in the command is
  2078. entered will be left.
  2079.  
  2080. Alternative: PART
  2081.  
  2082. Related: CHANNEL CYCLE JOIN
  2083.  
  2084. EXAMPLES:
  2085.  
  2086. /LEAVE
  2087.      Leave the channel currently bound to this window.
  2088.  
  2089. /LEAVE #AmigaGER
  2090.      Leave channel #AmigaGER.
  2091.  
  2092. Commands
  2093. ========
  2094.  
  2095. LINKS
  2096. -----
  2097.  
  2098. Usage: /LINKS [pattern]
  2099.  
  2100. LINKS shows which server of the IRC network is connected to which other
  2101. server. The optional [pattern] can be used to limit the shown server
  2102. with a mask.
  2103.  
  2104. Related: MAP
  2105.  
  2106. EXAMPLES:
  2107.  
  2108. /LINKS *.*com
  2109.      Shows all links with servers ending with .com
  2110.  
  2111. Commands
  2112. ========
  2113.  
  2114. LIST
  2115. ----
  2116.  
  2117. Usage: /LIST [pattern] [MIN minusers]
  2118.  
  2119. Shows the Windows in which the accessible channels are listed. The
  2120. optional [pattern] is used as a mask and the MIN minusers parameter
  2121. prevents channels with less users to be displayed.
  2122.  
  2123. EXAMPLES:
  2124.  
  2125. /LIST
  2126.      Returns a list of all public channels on available. Note that
  2127.      'secret' channels are only shown when the user has actually joined
  2128.      them.
  2129.  
  2130. /LIST br* 6
  2131.      Returns all channels starting with br and minimal 6 users
  2132.      present.
  2133.  
  2134. Commands
  2135. ========
  2136.  
  2137. LOAD
  2138. ----
  2139.  
  2140. Usage: /LOAD plugin
  2141.  
  2142. With this command you can force AmIRC to load a certain plugin that has
  2143. been installed after AmIRC was started.
  2144.  
  2145. Related: RELOAD UNLOAD
  2146.  
  2147. EXAMPLES:
  2148. /LOAD XDCC
  2149.      Forces AmIRC to load the XDCC plugin
  2150.  
  2151. Commands
  2152. ========
  2153.  
  2154. LOG
  2155. ---
  2156.  
  2157. Usage: /LOG [filename|ON|OFF]
  2158.  
  2159. LOG allows you to start/stop logging, as well as setting the log
  2160. filename and displaying status of logging.
  2161.  
  2162. EXAMPLES:
  2163.  
  2164. /LOG
  2165.      Displays current status of logging
  2166.  
  2167. /LOG ON
  2168.      Begins logging to the log file
  2169.  
  2170. /LOG <filename>
  2171.      Sets the path and name of the log file.
  2172.  
  2173. Commands
  2174. ========
  2175.  
  2176. LUSERS
  2177. ------
  2178.  
  2179. Usage: /LUSERS (no arguments)
  2180.  
  2181. Returns information on the current network. Specifically on the number
  2182. of users present.
  2183.  
  2184. EXAMPLES:
  2185.  
  2186. /LUSERS
  2187.      This will return information on the users on the current network.
  2188.  
  2189. Commands
  2190. ========
  2191.  
  2192. M
  2193. -
  2194.  
  2195. Usage: /M nick_or_channel[,nick,...] text
  2196.  
  2197. Sends a Private Message to one or more users. Note that this is
  2198. different from a DCC, in that /M (PRIVMSG) is sent through the IRC
  2199. server to the recipient. Note that the TAB key will cycle back and
  2200. forth through the users who have /MSG'ed you. This will appear in the
  2201. input string gadget, and you may simply add your message after it.
  2202.  
  2203. Alternative: MSG RMSG
  2204.  
  2205. EXAMPLES:
  2206.  
  2207. /M Kenneth Heya Dude! How's Florida?
  2208.      Send the message: "Heya Dude! How's Florida?" to user
  2209.      Kenneth.
  2210.  
  2211. /M Kenneth,Aerosoul I am in Pittsburgh
  2212.      Sends the message "I am in Pittsburgh" to Kenneth and
  2213.      Aerosoul.
  2214.  
  2215. Commands
  2216. ========
  2217.  
  2218. MAP
  2219. ---
  2220.  
  2221. Usage: /MAP [server]
  2222.  
  2223. MAP returns a map of all servers the network consists of. The optional
  2224. parameter is used as a mask
  2225.  
  2226. Related: LINKS
  2227.  
  2228. EXAMPLES:
  2229.  
  2230. /MAP
  2231.      Shows a map of all servers
  2232.  
  2233. /MAP *.*.com
  2234.      Shows a map of all servers ending with com.
  2235.  
  2236. Commands
  2237. ========
  2238.  
  2239. ME
  2240. --
  2241.  
  2242. Usage: /ME Action
  2243.  
  2244. ME sends a CTCP to the channel.
  2245.  
  2246. Related: DESCRIBE
  2247.  
  2248. EXAMPLES:
  2249.  
  2250. /ME is currently happy.
  2251.      Sends the following text to the channel:
  2252.      '<Action><nick> is currently happy'.
  2253.      Where <nick> is the currently selected nickname.
  2254.  
  2255. Commands
  2256. ========
  2257.  
  2258. MODE
  2259. ----
  2260.  
  2261. Usage: /MODE [channel] [+-modes [modeparms]]
  2262.  
  2263. MODE is used to change the modes of a channel or a user. Only Channel
  2264. Operators can change Channel Modes. Here's a list of all available
  2265. modes:
  2266.  
  2267.  
  2268.      o - Remove Channel Operator status. Note that you cannot set ChanOp status using +o.
  2269.      p - Private channel; Not visible in the Channel List.
  2270.      s - Secret channel; Not visible until you enter.
  2271.      i - Invite-only channel; Only accessible on invitation.
  2272.      t - Topic protection; Settable by Channel Operators only.
  2273.      n - No Messages; No messages from clients outside channel.
  2274.      m - Moderated channel; Only ChanOps and people with VOICE can send public messages.
  2275.      l - Limit: Set maximum number of users allowed on channel.
  2276.      b - Ban: Set a ban to keep users out.
  2277.      v - Voice: Give/take the ability to speak on a Moderated channel.
  2278.      k - Keyword: Set a channel keyword (password).
  2279.  
  2280. Related: BAN BANDEL INVITE OP DEOP TOPIC VOICE UMODE UNVOICE
  2281.  
  2282. EXAMPLES:
  2283.  
  2284. /MODE #AmIRC +tm
  2285.      Sets topic protection and makes channel #AmIRC moderated.
  2286.  
  2287. /MODE #AmIRC -o Sarek
  2288.      Removes channel operator status from user 'Sarek' on channel
  2289.      #AmIRC.
  2290.  
  2291. /MODE #AmIRC +l 50
  2292.      Sets limit of 50 users on #AmIRC.
  2293.  
  2294. /MODE #AmIRC -l
  2295.      Removes the limit form #AmIRC.
  2296.  
  2297. Commands
  2298. ========
  2299.  
  2300. MOTD
  2301. ----
  2302.  
  2303. Usage: /MOTD (no arguments)
  2304.  
  2305. This returns the Message Of The Day of the server currently connected
  2306. to.
  2307.  
  2308. EXAMPLES:
  2309.  
  2310. /MOTD
  2311.      Shows the current Message Of The Day of the server.
  2312.  
  2313. Commands
  2314. ========
  2315.  
  2316. MSG (PRIVMSG)
  2317. -------------
  2318.  
  2319. Usage: /MSG nick_or_channel[,nick,...] text
  2320.  
  2321. Sends a Private Message to one or more users. Note that this is
  2322. different from a DCC, in that a /MSG (PRIVMSG) is sent through the IRC
  2323. server to the recipient. Note that the TAB key will cycle back and
  2324. forth through the users who have /MSG'ed you. This will appear in the
  2325. input string gadget, and you may simply add your message after it.
  2326.  
  2327. Alternatives: M RMSG EXAMPLES:
  2328.  
  2329. /MSG Kenneth Heya Dude! How's Florida?
  2330.      Send the message: "Heya Dude! How's Florida?" to user 'Kenneth'.
  2331.  
  2332. /MSG Kenneth,Aerosoul I am in Pittsburgh
  2333.      Sends the message "I am in Pittsburgh" to Kenneth and Aerosoul.
  2334.  
  2335. Commands
  2336. ========
  2337.  
  2338. Names
  2339. -----
  2340.  
  2341. Usage /NAMES channel[,channel[,...]]
  2342.  
  2343. Gives a list of nicknames on any channel visible to the user (not
  2344. secret or private, or one actually joined by the user performing the
  2345. command).
  2346.  
  2347. EXAMPLES:
  2348.  
  2349. /NAMES #AmIRC,#amigaGER
  2350.      Will list all users on channels #AmIRC and #amigaGER, provided the
  2351.      channels are visible to the user.
  2352.  
  2353. /NAMES
  2354.      Will return a list of all visible channels and users (Strongly
  2355.      Discouraged!)
  2356.  
  2357. Commands
  2358. ========
  2359.  
  2360. NICK
  2361. ----
  2362.  
  2363. Usage: /NICK NewNick
  2364.  
  2365. NICK is used to give yourself a nickname or change your current one. If
  2366. the chosen nick is already in use, you will be notified of this and
  2367. prompted for a new nick.
  2368.  
  2369. Alternative: IRCNAME
  2370.  
  2371. EXAMPLES:
  2372.  
  2373. /NICK Phalanx
  2374.      Sets your nickname to 'Phalanx'
  2375.  
  2376. Commands
  2377. ========
  2378.  
  2379. NOTE
  2380. ----
  2381.  
  2382. Usage: /NOTE [undefined]
  2383.  
  2384. This command is still a leftover from the past and is not supported any
  2385. more by any current servers.
  2386.  
  2387. Commands
  2388. ========
  2389.  
  2390. NOTICE
  2391. ------
  2392.  
  2393. Usage: /NOTICE nick_or_channel[,nick,...] text
  2394.  
  2395. /NOTICE is usually used by Bots or clients being controlled by scripts.
  2396. /NOTICE messages must never be responded to by an automatic reply.
  2397.  
  2398. See MSG for syntax examples.
  2399.  
  2400. Commands
  2401. ========
  2402.  
  2403. NOTIFY
  2404. ------
  2405.  
  2406. Usage: /NOTIFY [nick]
  2407.  
  2408. With NOTIFY you can specify the nick of a user you want to be notified
  2409. of when he joins IRC. You can set the notification event in the Events
  2410. of the Settings. When no nick is submitted you will be presented with
  2411. the Windows.
  2412.  
  2413. EXAMPLES:
  2414.  
  2415. /NOTIFY Bert
  2416.      You will be notified when user Bert is joining the IRC network.
  2417.  
  2418. Commands
  2419. ========
  2420.  
  2421. OP
  2422. --
  2423.  
  2424. Usage: /OP [channel] nick[,nick...]
  2425.  
  2426. With this command you can set the Channel Operator status of a user or
  2427. several users at once.
  2428.  
  2429. EXAMPLES:
  2430.  
  2431. /OP Bert,Franky
  2432.      Sets the Channel Operator status for users Bert and
  2433.      Franky
  2434.  
  2435. Commands
  2436. ========
  2437.  
  2438. OPER
  2439. ----
  2440.  
  2441. Usage: /OPER user password
  2442.  
  2443. Allows users to set their IRC Operator status. You will need to know the
  2444. password to become IRC Operator. Using /OPER without it's parameters
  2445. will present you with a requester where you can enter your username and
  2446. password.
  2447.  
  2448. EXAMPLES:
  2449.  
  2450. /OPER Bill Bucks
  2451.      Sets user Bill IRC Operator status using password Bucks.
  2452.  
  2453. Commands
  2454. ========
  2455.  
  2456. PART
  2457. ----
  2458.  
  2459. Usage: /PART [Channel[,Channel...]]
  2460.  
  2461. Leaves a channel. If you don't give a channel name as a parameter, the
  2462. channel currently bound to the window in which in the command is
  2463. entered will be left.
  2464.  
  2465. Alternative: LEAVE
  2466.  
  2467. Related: CHANNEL CYCLE JOIN
  2468.  
  2469. EXAMPLES:
  2470.  
  2471. /PART
  2472.      Leave the channel currently bound to this window.
  2473.  
  2474. /PART #AmigaGER
  2475.      Leave channel #AmigaGER.
  2476.  
  2477. Commands
  2478. ========
  2479.  
  2480. PING
  2481. ----
  2482.  
  2483. Usage: /PING [nick]
  2484.  
  2485. Sends a CTCP to the user with the submitted nick and return the time it
  2486. took to receive it back. If no nick is given the PING will be sent to
  2487. the server.
  2488.  
  2489. Related: CTCP
  2490.  
  2491. EXAMPLES:
  2492.  
  2493. /PING Bill
  2494.      Will send a PING to Bill and return:
  2495.               «Pong»  PING Response received from Bill: 2.4s
  2496.  
  2497. Commands
  2498. ========
  2499.  
  2500. QKICK
  2501. -----
  2502.  
  2503. Usage: /QKICK [channel] nick[,nick...] [reason]
  2504.  
  2505. This command is use to kick or ban a person and presents you with a
  2506. window in which you can select the hostmask use for the ban. Pressing
  2507. either the Kick or Kick&Ban button will kick(ban) the user. Here's
  2508. the hostmasks offered:
  2509.  
  2510.      nick!*user@host.do.main : Bans a specific user with a specific nick.
  2511.      *!*@*.do.main : Ban all users of do.main.
  2512.      *!*user@host.do.main : Ban a user with a specific host.
  2513.      *!*@ip1.ip2.ip3.* : Numerical hostmask, banning all users in a domain.
  2514.  
  2515. Alternative: QKICKBAN
  2516.  
  2517. Related: BAN BANDEL BANLIST KICK KICKBAN
  2518.  
  2519. EXAMPLES:
  2520.  
  2521. /QKICK
  2522.      You will be presented with a Kick/Ban window
  2523.  
  2524. Commands
  2525. ========
  2526.  
  2527. QKICKBAN
  2528. --------
  2529.  
  2530. Usage: /QKICKBAN [channel] nick[,nick...] [reason]
  2531.  
  2532. This command is use to kick or ban a person and presents you with a
  2533. window in which you can select the hostmask use for the ban. Pressing
  2534. either the Kick or Kick&Ban button will kick(ban) the user. Here's
  2535. the hostmasks offered:
  2536.  
  2537.      nick!*user@host.do.main : Bans a specific user with a specific nick.
  2538.      *!*@*.do.main : Ban all users of do.main.
  2539.      *!*user@host.do.main : Ban a user with a specific host.
  2540.      *!*@ip1.ip2.ip3.* : Numerical hostmask, banning all users in a domain.
  2541.  
  2542. Alternative: QKICK
  2543.  
  2544. Related: BAN BANDEL BANLIST KICK KICKBAN
  2545.  
  2546. EXAMPLES:
  2547.  
  2548. /QKICKBAN
  2549.      You will be presented with a Kick/Ban window
  2550.  
  2551. Commands
  2552. ========
  2553.  
  2554. QUERY
  2555. -----
  2556.  
  2557. Usage: /QUERY nick
  2558.  
  2559. With this command you can open a Query window. From here, you can PING
  2560. or WHOIS the other user, or you may initiate a 'DCC Send' or 'DCC
  2561. Chat'. Starting a 'DCC Chat' from this window will allow you to
  2562. carry on a dialogue with the remote user through the window. If you
  2563. issue the command with a nick that has an iconified Query window, it
  2564. will be uniconified.
  2565.  
  2566. EXAMPLES:
  2567.  
  2568. /QUERY Hero
  2569.      Will open a Query window with user Hero.
  2570.  
  2571. Commands
  2572. ========
  2573.  
  2574. QUIT
  2575. ----
  2576.  
  2577. Usage: /QUIT [Quit message]
  2578.  
  2579. Used to end an IRC session. The optional [Quit message] is the text that
  2580. will be displayed upon quitting.
  2581.  
  2582. Related: SERVER
  2583.  
  2584. EXAMPLES:
  2585.  
  2586. /QUIT Gone to have lunch
  2587.      Will quit AmIRC and send the text 'Gone to have lunch' to all
  2588.      joined channels.
  2589.  
  2590. Commands
  2591. ========
  2592.  
  2593. QUOTE
  2594. -----
  2595.  
  2596. Usage: /QUOTE Raw_data_to_send_to_IRC_server
  2597.  
  2598. Sends text directly to the IRC server without any further processing.
  2599. Warning: Don't even think about using this command without interior
  2600. knowledge of the IRC protocol, or you might run into severe trouble.
  2601. See `RFC 1459' for a description of the IRC protocol.
  2602.  
  2603. Alternative: RAW
  2604.  
  2605. EXAMPLES:
  2606.  
  2607. /QUOTE JOIN #IRC-Heros
  2608.      Send the string JOIN #IRC-Heros directly to the IRC server.
  2609.  
  2610. Commands
  2611. ========
  2612.  
  2613. RAW
  2614. ---
  2615.  
  2616. Usage: /RAW Raw_data_to_send_to_IRC_server
  2617.  
  2618. Sends text directly to the IRC server without any further processing.
  2619. Warning: Don't even think about using this command without interior
  2620. knowledge of the IRC protocol, or you might run into severe trouble.
  2621. See `RFC 1459' for a description of the IRC protocol.
  2622.  
  2623. Alternative: QUOTE
  2624.  
  2625. EXAMPLES:
  2626.  
  2627. /RAW JOIN #IRC-Heros
  2628.      Send the string JOIN #IRC-Heros directly to the IRC server.
  2629.  
  2630. Commands
  2631. ========
  2632.  
  2633. RECONNECT
  2634. ---------
  2635.  
  2636. Usage: /RECONNECT
  2637.  
  2638. This command will reconnect you to the current server. It is the same
  2639. as the menu item and can be useful when a connection is either timed out
  2640. or lagging.
  2641.  
  2642. EXAMPLES:
  2643.  
  2644. /RECONNECT
  2645.      Will reconnect you to the current server.
  2646.  
  2647. Commands
  2648. ========
  2649.  
  2650. REHASH
  2651. ------
  2652.  
  2653. Usage: /REHASH (no arguments)
  2654.  
  2655. The rehash message can be used by the operator to force the server to
  2656. re-read and process its configuration file. It's can only be used by
  2657. IRC Operators.
  2658.  
  2659. EXAMPLES:
  2660.  
  2661. /REHASH
  2662.      Will cause the IRC server to reread it's configuration file.
  2663.  
  2664. Commands
  2665. ========
  2666.  
  2667. RELOAD
  2668. ------
  2669.  
  2670. Usage: /RELOAD plugin [FORCE]
  2671.  
  2672. This command will make AmIRC reload a plugin that has already been
  2673. loaded. This can be useful if the plugin has been updated. The FORCE
  2674. option will force AmIRC to reload if the plugin refuses to unload.
  2675.  
  2676. Related: LOAD UNLOAD
  2677.  
  2678. EXAMPLES:
  2679.  
  2680. /RELOAD XDCC
  2681.      Will make AmIRC reload the XDCC plugin.
  2682.  
  2683. Commands
  2684. ========
  2685.  
  2686. RESTART
  2687. -------
  2688.  
  2689. Usage: /RESTART (no arguments)
  2690.  
  2691. This command is used to reset the IRC server. Note that this command
  2692. can only be used by IRC Operators.
  2693.  
  2694. EXAMPLES:
  2695.  
  2696. /RESTART
  2697.      Will reset the IRC server
  2698.  
  2699. Commands
  2700. ========
  2701.  
  2702. RMSG
  2703. ----
  2704.  
  2705. Usage: /RMSG nick_or_channel[,nick,...] text
  2706.  
  2707. Sends a Private Message to one or more users. Note that this is
  2708. different from a DCC, in that /M (PRIVMSG) is sent through the IRC
  2709. server to the recipient. Note that the TAB key will cycle back and
  2710. forth through the users who have /MSG'ed you. This will appear in the
  2711. input string gadget, and you may simply add your message after it.
  2712.  
  2713. Alternative: M MSG
  2714.  
  2715. EXAMPLES:
  2716.  
  2717. /RMSG Kenneth Heya Dude! How's Florida?
  2718.      Send the message: "Heya Dude! How's Florida?" to user 'Kenneth'.
  2719.  
  2720. /RMSG Kenneth,Aerosoul I am in Pittsburgh
  2721.      Sends the message "I am in Pittsburgh" to Kenneth and Aerosoul.
  2722.  
  2723. Commands
  2724. ========
  2725.  
  2726. RX
  2727. --
  2728.  
  2729. Usage: /RX rxcommand [parms]
  2730.  
  2731. This command is used to start any of the Arexx commands that are in
  2732. AmIRC's Rexx directory. A complete Rexx guide is also available.
  2733.  
  2734. Related: RXRETURN
  2735.  
  2736. EXAMPLES:
  2737.  
  2738. /RX leave
  2739.      Will start the Arexx command 'Leave.amirx' if present.
  2740.  
  2741. Commands
  2742. ========
  2743.  
  2744. RXRETURN
  2745. --------
  2746.  
  2747. Usage: /RXRETURN Command [Rest]
  2748.  
  2749. /RXRETURN is only useful to ARexx script authors. It will cause any
  2750. pending GETREXXLINE commands to immediately return with the arguments
  2751. given to it."
  2752.  
  2753. Related: RX
  2754.  
  2755. Commands
  2756. ========
  2757.  
  2758. SERVER
  2759. ------
  2760.  
  2761. Usage: /SERVER [server [port [password]]]
  2762.  
  2763. You can use this command to connect to a different server or to get
  2764. information about the currently connected server.
  2765.  
  2766. Related: QUIT
  2767.  
  2768. EXAMPLES:
  2769.  
  2770. /SERVER irc.server.com
  2771.      Connects you to the server irc.server.com
  2772.  
  2773. /SERVER
  2774.      Shows current connection information
  2775.  
  2776. Commands
  2777. ========
  2778.  
  2779. SILENCE
  2780. -------
  2781.  
  2782. Usage: /SILENCE [[+|-]nick|userhost]
  2783.  
  2784. SILENCE can be used to block all CTCP traffic from a certain user or
  2785. userhost.  Meaning for instance that no MSG or DCC will be received
  2786. from that user.
  2787.  
  2788. Related: IGNORE UNIGNORE
  2789.  
  2790. EXAMPLES:
  2791.  
  2792. /SILENCE
  2793.      Shows a list of all currently silenced users.
  2794.  
  2795. /SILENCE +Bill
  2796.      Will silence user Bill
  2797.  
  2798. /SILENCE -Friend
  2799.      Will remove Friend from the Silence list.
  2800.  
  2801. Commands
  2802. ========
  2803.  
  2804. SOUND
  2805. -----
  2806.  
  2807. Usage: /SOUND soundfile[.wav] action_text
  2808.  
  2809. This command can be used to have all clients on a channel play a
  2810. certain sound.  Please note that the sound file must be present on the
  2811. user's system to be able to play it, so don't use this randomly as
  2812. nobody will hear a thing when the submitted filename is not found.
  2813.  
  2814. EXAMPLES:
  2815.  
  2816. /SOUND Burp
  2817.      Will play the sound file Burp.wav on all user's system, if found!
  2818.  
  2819. /SOUND Burp Excuse me!
  2820.      Will play the soundfile and send the text 'Excuse me!' with it.
  2821.  
  2822. Commands
  2823. ========
  2824.  
  2825. SQUIT
  2826. -----
  2827.  
  2828. Usage: /SQUIT server
  2829.  
  2830. This command is used to disconnect a server from the network. Note that
  2831. only IRC Operators have access to this command.
  2832.  
  2833. EXAMPLES:
  2834.  
  2835. /SQUIT irc.server.com
  2836.      Will quit server irc.server.com
  2837.  
  2838. Commands
  2839. ========
  2840.  
  2841. STATS
  2842. -----
  2843.  
  2844. Usage: /STATS [server] [query]
  2845.  
  2846. The STATS command is used to query statistics of certain server. If the
  2847. [server] parameter is omitted, only the end of statistics reply is sent
  2848. back. The implementation of this command is highly dependent on the
  2849. server which replies, although the server must be able to supply
  2850. information as described by the queries below (or similar).
  2851.  
  2852. The currently supported queries are:
  2853.  
  2854.      c - Returns a list of servers which the server may connect to or allow connections
  2855.      from.
  2856.      h - Returns a list of servers which are either forced to be treated as leaves or
  2857.      allowed to act as hubs.
  2858.      i - Returns a list of hosts which the server allows a client to connect from.
  2859.      k - Returns a list of banned username/hostname combinations for that server.
  2860.      l - Returns a list of the server's connections, showing how long each connection
  2861.      has been established and the traffic over that connection in bytes and messages
  2862.      for each direction.
  2863.      m - Returns a list of commands supported by the server and the usage count for
  2864.      each if the usage count is non zero.
  2865.      o - Returns a list of hosts from which normal clients may become operators.
  2866.      y - Show Y (Class) lines from server's configuration file.
  2867.      u - Returns a string showing how long the server has been up.
  2868.  
  2869. EXAMPLES:
  2870.  
  2871. /STATS irc.server.com u
  2872.      Shows how long server irc.server.com has been up
  2873.  
  2874. Commands
  2875. ========
  2876.  
  2877. SUMMON
  2878. ------
  2879.  
  2880. Usage: /SUMMON user
  2881.  
  2882. The SUMMON command can be used to give users who are on a host running
  2883. an IRC server a message asking them to please join IRC. This message is
  2884. only sent if the target server (a) has SUMMON enabled, (b) the user is
  2885. logged in and (c) the server process can write to the user's tty (or
  2886. similar).
  2887.  
  2888. EXAMPLES:
  2889.  
  2890. /SUMMON John
  2891.      Will ask user John to join IRC.
  2892.  
  2893. Commands
  2894. ========
  2895.  
  2896. TIME
  2897. ----
  2898.  
  2899. Usage: /TIME [server]
  2900.  
  2901. Returns the local time from the server. If the optional [server]
  2902. argument is given, then that servers local time will be returned.
  2903.  
  2904. EXAMPLES:
  2905.  
  2906. /TIME irc.pitt.edu
  2907.      Returns the local time from server irc.pitt.edu.
  2908.  
  2909. Commands
  2910. ========
  2911.  
  2912. TOPIC
  2913. -----
  2914.  
  2915. Usage: /TOPIC [channel] [New Topic]
  2916.  
  2917. The topic command alone will display the channels topic. If the optional
  2918. [New Topic] argument is given, the topic will be changed to the
  2919. argument given, provided that the topic is not protected, or the user
  2920. issuing the command is an operator on the channel.
  2921.  
  2922. Related: MODE
  2923.  
  2924. EXAMPLES:
  2925.  
  2926. /TOPIC #AmIRC
  2927.      Will display the current topic on #AmIRC.
  2928.  
  2929. /TOPIC #AmIRC Amigas Rule!
  2930.      Will replace the current topic of #AmIRC with the topic 'Amigas
  2931.      Rule'
  2932.  
  2933. Commands
  2934. ========
  2935.  
  2936. TRACE
  2937. -----
  2938.  
  2939. Usage: /TRACE [server|nick]
  2940.  
  2941. TRACE is used to find the route to specific server. If the parameter is
  2942. omitted, it will return which servers the current server has a direct
  2943. connection to. If the destination given is a nickname, only a reply for
  2944. that nickname is given. If the destination is an actual server, then
  2945. the destination server is required to report all servers and users which
  2946. are connected to it, although only operators are permitted to see users
  2947. present.
  2948.  
  2949. EXAMPLES:
  2950.  
  2951. /TRACE Bill
  2952.      Traces connection to user Bill.
  2953.  
  2954. Commands
  2955. ========
  2956.  
  2957. UMODE
  2958. -----
  2959.  
  2960. Usage: /UMODE [usermodes]
  2961.  
  2962. UMODE is used to set your own usermodes. The available options are:
  2963.  
  2964.      o - Chan Op: Sets/Takes Channel Operator status
  2965.      i - Invisible: Sets Visible/Invisible (in global userlist).
  2966.      w - Wallops: Allows receiving of texts sent to all Operators.
  2967.      s - Server Notices: Allows receiving of Server Notices.
  2968. Related: MODE
  2969.  
  2970. EXAMPLES:
  2971.  
  2972. /UMODE i
  2973.      Makes you invisible to the global userlist.
  2974.  
  2975. Commands
  2976. ========
  2977.  
  2978. UNHIGHLITE
  2979. ----------
  2980.  
  2981. Usage: /UNHIGHLITE [item]
  2982.  
  2983. HIGHLITE can be used to light up certain texts. They will be shown in a
  2984. colour that's defined in the Colors.
  2985.  
  2986. You can also change Highlighting using the Lists.
  2987.  
  2988. Alternative: UNHILITE
  2989.  
  2990. Related: HIGHLITE HILITE
  2991.  
  2992. EXAMPLES:
  2993.  
  2994. /UNHIGHLITE MyName
  2995.      Will remove MyName from the Highlight List.
  2996.  
  2997. Commands
  2998. ========
  2999.  
  3000. UNHILITE
  3001. --------
  3002.  
  3003. HIGHLITE can be used to light up certain texts. They will be shown in a
  3004. colour that's defined in the Colors.
  3005.  
  3006. You can also change Highlighting using the Lists.
  3007.  
  3008. Alternative: UNHILITE
  3009.  
  3010. Related: HIGHLITE HILITE
  3011.  
  3012. Usage: /UNHILITE [item]
  3013.  
  3014. EXAMPLES:
  3015.  
  3016. /UNHILITE MyName
  3017.      Will remove MyName from the Highlight List.
  3018.  
  3019. Commands
  3020. ========
  3021.  
  3022. UNIGNORE
  3023. --------
  3024.  
  3025. Usage: /UNIGNORE [userhost|nick]
  3026.  
  3027. Removes the Ignore state of a user. Will show current ignores when no
  3028. argument is submitted.
  3029.  
  3030. Related: IGNORE SILENCE
  3031.  
  3032. EXAMPLES:
  3033.  
  3034. /UNIGNORE
  3035.      Shows a list of all currently ignored users
  3036.  
  3037. /UNIGNORE Franky
  3038.      Will remove all ignores on Franky
  3039.  
  3040. Commands
  3041. ========
  3042.  
  3043. UNLOAD
  3044. ------
  3045.  
  3046. Usage: /UNLOAD plugin [FORCE]
  3047.  
  3048. Will make AmIRC unload a plugin. The FORCE option will force the plugin
  3049. to be unloaded.
  3050.  
  3051. Related: LOAD RELOAD
  3052.  
  3053. EXAMPLES:
  3054.  
  3055. /UNLOAD XDCC
  3056.      Makes AmIRC unload the XDCC plugin.
  3057.  
  3058. Commands
  3059. ========
  3060.  
  3061. UNVOICE
  3062. -------
  3063.  
  3064. Usage: /UNVOICE [channel] nick[,nick...]
  3065.  
  3066. Will remove a user's Voice status. You can specify a certain channel
  3067. and submit multiple users.
  3068.  
  3069. Related: VOICE
  3070.  
  3071. EXAMPLES:
  3072.  
  3073. /UNVOICE Boy
  3074.      Will remove the Voice status of Boy
  3075.  
  3076. Commands
  3077. ========
  3078.  
  3079. UNPING
  3080. ------
  3081.  
  3082. Usage: /UPING host
  3083.  
  3084. UPING is used by IRCops to ping a certain host. Mainly used for
  3085. debugging the network and see if connections are alive.
  3086.  
  3087. EXAMPLES:
  3088.  
  3089. /UPING irc.network.com
  3090.      Send a Ping packet to irc.network.com.
  3091.  
  3092. Commands
  3093. ========
  3094.  
  3095. USERS
  3096. -----
  3097.  
  3098. Usage: /USERS [host]
  3099.  
  3100. The USERS command returns a list of users logged into the server in a
  3101. similar format to who, rusers and finger. This command is frequently
  3102. disabled for security related reasons.
  3103.  
  3104. Related: FINDHOST USERHOST WHO
  3105.  
  3106. EXAMPLES:
  3107.  
  3108. /USERS *.microsoft.com
  3109.      Will show all user connected to *.microsoft.com.
  3110.  
  3111. Commands
  3112. ========
  3113.  
  3114. USERHOST
  3115. --------
  3116.  
  3117. Usage: /USERHOST nick[,nick[,...]]
  3118.  
  3119. Returns the login@domain for the specified nickname(s). Up to five
  3120. nicknames may be specified, each separated by a <space>.
  3121.  
  3122. Related: FINDHOST USERS WHO
  3123.  
  3124. EXAMPLES:
  3125.  
  3126. /USERHOST DuRaN
  3127.      Returns: DuRaN is DuRaN@calci.amiganet.pgh.net
  3128.  
  3129. Commands
  3130. ========
  3131.  
  3132. VERSION
  3133. -------
  3134.  
  3135. Usage /VERSION [nick|server]
  3136.  
  3137. Returns the version of the server's software. If the optional [server]
  3138. argument is given, returns the version of the specified server's
  3139. software. When a user's nick is given instead it will return the user's
  3140. client software version and info.
  3141.  
  3142. EXAMPLES:
  3143.  
  3144. /VERSION *.edu
  3145.      Returns server version information for all servers matching
  3146.      '*.edu'.
  3147.  
  3148. /VERSION Franky
  3149.      Will return information and version of Franky's client software.
  3150.  
  3151. Commands
  3152. ========
  3153.  
  3154. VOICE
  3155. -----
  3156.  
  3157. Usage /VOICE [channel] nick[,nick...]
  3158.  
  3159. You can give a user a Voice with this command. A voice is needed on a
  3160. Moderated channel to be able to speak. (See MODE for details).
  3161.  
  3162. Related: UNVOICE
  3163.  
  3164. EXAMPLES:
  3165.  
  3166. /VOICE Sinatra
  3167.      Gives a Voice to user Sinatra.
  3168.  
  3169. Commands
  3170. ========
  3171.  
  3172. WALLOPS
  3173. -------
  3174.  
  3175. Usage /WALLOPS text_to_broadcast
  3176.  
  3177. Sends a text to all Operators who have 'Receiving WALLOPS' enabled.
  3178. This command is mainly used by servers.
  3179.  
  3180. EXAMPLES:
  3181.  
  3182. /WALLOPS Greeting to you all!
  3183.      Sends the text 'Greeting to you all!' to all Operators.
  3184.  
  3185. Commands
  3186. ========
  3187.  
  3188. WHO
  3189. ---
  3190.  
  3191. Usage: /WHO channel|pattern
  3192.  
  3193. Returns a generated list of all users matching the criteria passed to
  3194. the command, i/e. everyone at a particular channel, or matching a
  3195. particular pattern.
  3196.  
  3197. Related: FINDHOST USERS USERHOST
  3198.  
  3199. EXAMPLES:
  3200.  
  3201. /WHO *.cmu.edu
  3202.      Will list all users at the cmu.edu domain.
  3203.  
  3204. /WHO #Amiga
  3205.      Shows all users on #Amiga.
  3206.  
  3207. Commands
  3208. ========
  3209.  
  3210. WHOIS
  3211. -----
  3212.  
  3213. Usage: /WHOIS nick[,nick[,...]]
  3214.  
  3215. Returns information about the specified user or users, that you are
  3216. allowed to see.
  3217.  
  3218. EXAMPLES:
  3219.  
  3220. /WHOIS Phalanx
  3221.      Returns available information about user 'Phalanx'.
  3222.  
  3223. Commands
  3224. ========
  3225.  
  3226. WHOWAS
  3227. ------
  3228.  
  3229. Usage /WHOWAS nick[,nick[,...]]
  3230.  
  3231. Returns information on a nick that no longer exists, due to the user
  3232. leaving the server or changing their nick.
  3233.  
  3234. EXAMPLES:
  3235.  
  3236. /WHOWAS Aerosoul
  3237.      Checks for and returns available information on the nick
  3238.      'Aerosoul'.
  3239.  
  3240. Customizing your environment
  3241. ****************************
  3242.  
  3243. Overview
  3244. ========
  3245.  
  3246. Now that you have AmIRC running, you may want to get it to operate the
  3247. way you want it to, and to look pleasing as well. This is achieved
  3248. through both the MUI preferences and AmIRC's Menu options.
  3249.  
  3250. MUI Settings
  3251. ************
  3252.  
  3253. Changing MUI Settings
  3254. =====================
  3255.  
  3256. Most of the configuration dealing with how AmIRC's GUI appears can be
  3257. customized with MUI. Check the MUI Settings... entry under the
  3258. Settings menu. This will pop up MUI's interface, allowing you to
  3259. setup AmIRC's MUI Prefs, without disturbing any of your other MUI
  3260. configurations. Read the documentation for MUI to learn more about the
  3261. operation of MUI Preferences.
  3262.  
  3263. AmIRC Configuration
  3264. *******************
  3265.  
  3266. Customizing your environment
  3267. ============================
  3268.  
  3269. Most of the setup functions appear in the Setup entry under the
  3270. Settings menu. Here you will get a window that will allow you to
  3271. access several pages that deal with configuring AmIRC.
  3272.  
  3273. AmIRC Configuration
  3274. *******************
  3275.  
  3276. Messages Page
  3277. =============
  3278.  
  3279. Misc Messages
  3280. -------------
  3281.  
  3282. CTCP Userinfo
  3283.      The text in this string is what will be returned to a user who
  3284.      sends CTCP to your client.
  3285.  
  3286. KICK Reason
  3287.      If you are a channel operator and KICK another user from the
  3288.      Channel, this text will appear as the reason for the /KICK.
  3289.  
  3290. Quit Messages
  3291. -------------
  3292.  
  3293. Exit
  3294.      This will appear to users in the channel when you exit AmIRC.
  3295.  
  3296. New Server
  3297.      This text will appear to users in the channel when you select
  3298.      Select Server in the AmIRC menu, and pick a new server to
  3299.      connect to.
  3300.  
  3301. System reset
  3302.      This is the text to appear if you reboot your amiga (Ctrl-
  3303.      Amiga-Amiga) while connected to a server.
  3304.  
  3305. AWAY Messages
  3306. -------------
  3307.  
  3308. Default
  3309.      This is the text that will appear when you are set AWAY by
  3310.      selecting the Marked Away? item in the User Modes menu or
  3311.      using the AWAY command
  3312.  
  3313. AutoAWAY
  3314.      Text that appears when you are automatically set away due to
  3315.      inactivity.
  3316.  
  3317. Timeout
  3318.      This sets how much time will pass before AmIRC assumes you are
  3319.      away from the computer and marks you as AWAY. If set to 0 (Zero),
  3320.      time-out will be disabled.
  3321.  
  3322. UnAWAY
  3323.      This cycle gadget allows you to choose the conditions of which
  3324.      AmIRC will automatically set you to Not AWAY.
  3325.  
  3326. AmIRC Configuration
  3327. *******************
  3328.  
  3329. Events Page
  3330. ===========
  3331.  
  3332. Here you may define certain actions to take place upon incoming events.
  3333. These actions can be as simple as a warning beep from your Amiga, or a
  3334. complex and powerful Rexx command. The following text first explains
  3335. the functions of the columns of this page, and then goes on to explain
  3336. what each event is.
  3337.  
  3338. Columns
  3339. -------
  3340.  
  3341. Event
  3342.      The particular event for the action to take place on.
  3343.  
  3344. Deiconify
  3345.      If AmIRC is iconified, this will uniconify and bring to front the
  3346.      AmIRC window on the occurrence of the event.
  3347.  
  3348. Beep
  3349.      This will perform a system beep on the occurrence of the event
  3350.  
  3351. Sound
  3352.      If a sound sample is preferred for the event, you may use the
  3353.      requester gadget to pick a sound to play instead of the system
  3354.      beep. Please Note, AmIRC uses the DataTypes of OS 3.x for sounds,
  3355.      and you will not be able to use this feature under OS 2.x.
  3356.  
  3357. Vol
  3358.      This sets the volume for the sound sample. The valid range for the
  3359.      volume is 0 - 64.  This is a slider gadget. The small gadget just
  3360.      to the left of this slider gadget can be used to test the selected
  3361.      sound file.
  3362.  
  3363. Rexx Command
  3364.      Here you may configure a Rexx script to be run on the occurrence
  3365.      of the event.
  3366.  
  3367. Events
  3368. ------
  3369.  
  3370. Any Message
  3371.      This event occurs on any incoming public message.
  3372.  
  3373. Private Msg
  3374.      This event occurs when you receive an incoming private MSG or DCC
  3375.      message.
  3376.  
  3377. Notice
  3378.      This event occurs when an operator sends out a NOTICE.
  3379.  
  3380. CTCP request
  3381.      This event occurs when your client receives any CTCP request. (For
  3382.      example /CTCP Time, or /CTCP Version)
  3383.  
  3384. DCC request
  3385.      This event occurs on receiving a DCC file transfer request or chat
  3386.      request.
  3387.  
  3388. Join
  3389.      This event occurs when anyone JOIN the channel you are currently
  3390.      on.
  3391.  
  3392. Kick
  3393.      This event occurs when anyone is KICK from the channel you are
  3394.      currently on.
  3395.  
  3396. Mode change
  3397.      This event occurs when the channel mode is changed for the channel
  3398.      you are currently on. E.g. If someone is OPed or /DeOPed, or if the
  3399.      channel is made private, etc.
  3400.  
  3401. ISON Notify
  3402.      This event occurs when AmIRC 'sees' a user that is configured in
  3403.      your Notify list.
  3404.  
  3405. Connection
  3406.      This event occurs when AmIRC makes a connection to an IRC server.
  3407.  
  3408. Invite
  3409.      This event occurs when another user INVITE you to join a channel
  3410.      that is currently set to MODE Invite Only.
  3411.  
  3412. Highlite
  3413.      This even occurs upon receiving text that is configured in the
  3414.      Hilite section of the Lists setup.
  3415.  
  3416. AmIRC Configuration
  3417. *******************
  3418.  
  3419. Actions Page
  3420. ============
  3421.  
  3422. Action buttons
  3423. --------------
  3424.  
  3425. The main part of this window consists of a listview containing the
  3426. Label and Operation for all currently set up action buttons
  3427. that appear beneath the userlist in AmIRC's main window. You can
  3428. specify up to 96 action buttons.  They can contain any IRC action, much
  3429. like a macro. As AmIRC doesn't allow configurable function keys to act
  3430. as macros, these buttons are preset for CTCP, DCC and MODE operations.
  3431. Selecting an action from the listview will place it in the gadgets
  3432. below for editing.
  3433.  
  3434. Label:
  3435.      This is the label that will appear on the action button.
  3436.  
  3437. Operation:
  3438.      This is the operation that is executed when the action button is
  3439.      pressed. This can be anything you can enter in the channels input
  3440.      gadget. The bottom of the page contains a list with valid
  3441.      placeholders that will be replaced when the operation is executed.
  3442.  
  3443. Number of button pages
  3444.      This slider determines how many button pages there will be.
  3445.      Allowing you to separate the action buttons into different pages
  3446.      so they won't take up too much space on the screen. Each page has
  3447.      a tab that allows it to be selected.  The actions can be sorted in
  3448.      the list by dragging and dropping allowing you to determine the
  3449.      content of each button page.
  3450.  
  3451. Add New Action
  3452.      With this button a new action will be added to the list.
  3453.  
  3454. Delete Action
  3455.      With this button the currently selected action will be removed
  3456.      from the list.
  3457.  
  3458.      These actions can also be accessed by clicking the right mouse
  3459.      button after selecting a users nick from the userlist.
  3460.  
  3461. Special
  3462. -------
  3463.  
  3464. On this page you can set some special actions:
  3465.  
  3466. Userlist doubleclick
  3467.      This action will be performed when you double-click on a nick in
  3468.      the channel's userlist.
  3469.  
  3470. Nick button
  3471.      This action will be performed when you click on the button
  3472.      containing your own nick.
  3473.  
  3474. The bottom bar shows all valid placeholders for these actions which
  3475. will be replaced when the operation is executed.
  3476.  
  3477. AmIRC Configuration
  3478. *******************
  3479.  
  3480. Lists Page
  3481. ==========
  3482.  
  3483. Alias Page
  3484. ----------
  3485.  
  3486. Here you can create aliases, or short-cuts for complex IRC commands.
  3487. The main part of the page is taken up by the listview containing all
  3488. currently set up aliases. You can modify them by selecting them.
  3489.  
  3490. Add New Alias
  3491.      With this button you can add new aliases.
  3492.  
  3493. Delete Alias
  3494.      With this button you can remove the currently selected alias from
  3495.      the list.
  3496.  
  3497. The bottom bar contains an example template. %p will be replaced by
  3498. any arguments that you use when issuing the alias.
  3499.  
  3500. Ignore Page
  3501. -----------
  3502.  
  3503. Here you can set which users, if any, you want to IGNORE, and what kind
  3504. of messages from them to ignore.  The main part of the page consists of
  3505. the listview displaying all current ignores.  You can modify them by
  3506. selecting them.
  3507.  
  3508. Ignore Text
  3509.      When this item is checked any public message send by the user will
  3510.      be ignored.
  3511.  
  3512. Ignore PrivMsgs
  3513.      When this item is checked you won't see any MSG from the user.
  3514.  
  3515. Ignore CTCPs
  3516.      When this item is checked you won't receive any CTCP request from
  3517.      the user.
  3518.  
  3519. Add Ignore
  3520.      With this button a new ignore will be added to the list.
  3521.  
  3522. Delete Ignore
  3523.      This button will remove a selected ignore from the list.
  3524.  
  3525. Hilite Page
  3526. -----------
  3527.  
  3528. Here you may set certain text to be highlighted in order to get your
  3529. attention if that text appears.  The main part of the page is taken up
  3530. by the listview showing all currently set up patterns. You may edit any
  3531. entry by selecting it.
  3532.  
  3533. Add New Hilite pattern
  3534.      With this button you can add a new pattern to the list.  You may
  3535.      set text to match the Nick, Userhost, or any keyword enclosed in
  3536.      double quotes. The Hilite patterns will ignore a pattern it
  3537.      recognizes if it was input by you, but will be activate on the
  3538.      pattern from other users.
  3539.  
  3540. Pattern Definitions:
  3541. --------------------
  3542.  
  3543.     Nick
  3544.           This will watch the AmIRC listview for the nick that you
  3545.           specify, and highlight the text for that users message.  The
  3546.           'Nick' entry does not require double quotes.
  3547.  
  3548.     Userhost
  3549.           This will watch for messages that originate from a particular
  3550.           Userhost, and highlight the text for that message. Userhost
  3551.           entries may contain wildcards.  Examples:
  3552.  
  3553.          fred!fdoe@doe1.powernet.edu
  3554.                This will highlight only messages from fred at that
  3555.                particular address.
  3556.  
  3557.          fred!*@*
  3558.                This will highlight messages from anyone named fred,
  3559.                regardless of address or login name.
  3560.  
  3561.          Fred!*@*.powernet.edu
  3562.                This will highlight messages from anyone named fred on
  3563.                any machine on powernet.edu
  3564.  
  3565.          *!*@doe1.powernet.edu
  3566.                This will highlight any messages from anyone on the doe1
  3567.                machine at powernet.edu
  3568.  
  3569.          *!*@*
  3570.                This will highlight any messages from any user.
  3571.  
  3572.     "Keyword"
  3573.           This will highlight any message that contains the text
  3574.           enclosed in double quotes.
  3575.  
  3576.     'Keyword'
  3577.           This does the same as above but is case sensitive.
  3578.  
  3579. Delete Hilite pattern
  3580.      Select a pattern from the list and press this button to delete it.
  3581.  
  3582. AmIRC Configuration
  3583. *******************
  3584.  
  3585. Interface Page
  3586. ==============
  3587.  
  3588. The Interface configuration page allows you to control some specific
  3589. aspects of AmIRC that aren't covered in the MUI configuration.
  3590.  
  3591. General Page
  3592. ------------
  3593.  
  3594. Windows Limits
  3595. --------------
  3596.  
  3597. Scrollback Buffer Size:
  3598.      Here the size of the Scrollback buffer can be set (in lines).
  3599.  
  3600. Misc
  3601. ----
  3602.  
  3603. Inline URL/Email handling
  3604.      Here you can determine if AmIRC will sent the URL or Email address
  3605.      to your browser or email client by either single or double mouse
  3606.      click. Or you can disable it completely.
  3607.  
  3608. Timestamps
  3609.      With this you can determine if the time stamps that appear in
  3610.      front of each entry in the channel list will be either
  3611.      Short(hh:mm) or Long(hh:mm:ss), or you can disable
  3612.      them.
  3613.  
  3614. Window list action
  3615.      You can make the window either Uniconify/Iconify, where the
  3616.      windows will just re-open when uniconified, or Uniconify/Pop to
  3617.      front, where a window will pop to the front when uniconified.
  3618.  
  3619. Remember buffer position when iconified?
  3620.      When this item is selected AmIRC will remember the buffer position
  3621.      when it is being iconified.  When the interface is brought back up
  3622.      it will be at the same position in the buffer.
  3623.  
  3624. Hide page manipulation buttons?
  3625.      You can hide the buttons with which you can manipulate the pages.
  3626.  
  3627. Wheel mouse support
  3628. -------------------
  3629.  
  3630. Wheel scroll lines:
  3631.      Here you can determine how many lines will be scrolled at a time
  3632.      when the mouse wheel is used.
  3633.  
  3634. Channels Page
  3635. -------------
  3636.  
  3637. Fonts
  3638. -----
  3639.  
  3640. Channel text font
  3641.      Here you can specify an alternative channel text font that will be
  3642.      used in the main channel list. If none is specified the font set
  3643.      in the MUI Prefs will be used.
  3644.  
  3645. Userlist
  3646. --------
  3647.  
  3648. Userlist
  3649.      You can determine if the user list is visible or not visible, and
  3650.      if it is visible, if it is a separate window, or a part of the
  3651.      AmIRC window.
  3652.  
  3653. Order
  3654.      This gadget determines how the userlist will be shown. Either in
  3655.      Alpabetical Order, New at bottom or New at top.
  3656.  
  3657. Popup Menu
  3658.      You can select the Userlist popup menu to be Disabled, Same as
  3659.      Action Buttons or Complex(Hierarchical).
  3660.  
  3661. Buttons?
  3662.      You can have the Action buttons displayed below the user list.  If
  3663.      the user list is configured as a separate window, the buttons will
  3664.      also appear in that window.
  3665.  
  3666. Userlist win open?
  3667.      The userlist window can be opened upon start-up, if it is
  3668.      configured as a separate window.
  3669.  
  3670. Misc
  3671. ----
  3672.  
  3673. No Balance Bar?
  3674.      You can disable the Balance Bar between the user list and the
  3675.      channel list.
  3676.  
  3677. Hide Lag-O-Meter?
  3678.      You can hide the Lag-O-Meter from the main window.
  3679.  
  3680. 'Economy'channelmode buttons
  3681.      In 'Economy' mode the channel mode buttons are merged into a
  3682.      single button containing all the relevant switched that are set,
  3683.      leaving more space for other interface items.  If you want to set
  3684.      a channel mode you can click on the button to pop up the channel
  3685.      mode buttons
  3686.  
  3687. Dialogs Page
  3688. ------------
  3689.  
  3690. Fonts
  3691. -----
  3692.  
  3693. Dialog window font
  3694.      Here you can specify an alternative dialogue window font that will
  3695.      be used in the dialogue windows. If none is specified the font set
  3696.      in the MUI Prefs will be used.
  3697.  
  3698. Windows Limits
  3699. --------------
  3700.  
  3701. Maximum number of query windows:
  3702.      Here you can set how many QUERY windows there will be open maximum
  3703.      at a time.
  3704.  
  3705. No query windows when away?
  3706.      You can disable QUERY windows from opening when you are set AWAY.
  3707.  
  3708. Misc
  3709. ----
  3710.  
  3711. Query window on different Pubscreen
  3712.      Here you can set an alternative public screen on which the QUERY
  3713.      window will be opened. If no pubscreen is specified, the Query
  3714.      Window will open on AmIRC's default screen.
  3715.  
  3716. AmIRC Configuration
  3717. *******************
  3718.  
  3719. Colors Page
  3720. ===========
  3721.  
  3722. Text Colors
  3723. -----------
  3724.  
  3725. In this section, you may configure the colours that certain text will
  3726. appear in AmIRC. These colours are based on the MUI pen colours that
  3727. you have configured in MUI. Just click and hold on the cycle gadget to
  3728. see a list of the MUI Pen colours available.
  3729.  
  3730. Normal Text
  3731.      Text that is a normal message from a user.
  3732.  
  3733. Private Messages
  3734.      Text that is a private message from another user to you.
  3735.  
  3736. Mode Changes
  3737.      Text that shows a mode change for the channel.
  3738.  
  3739. Local Info
  3740.      Text that is generated by local events. E.g. Vapor's MicroDot-2
  3741.      notifying you of new mail.
  3742.  
  3743. Background
  3744.      The background colour of the listview(s).
  3745.  
  3746. Own Text
  3747.      Any text entered by you.
  3748.  
  3749. Nick Related
  3750.      Any text that contains a nick action.
  3751.  
  3752. Part Messages
  3753.      Text when someone leaves a channel.
  3754.  
  3755. Quit Messages
  3756.      Text when someone quits IRC.
  3757.  
  3758. Invite Messages
  3759.      Text of an invitation to a channel.
  3760.  
  3761. WhoIs Text
  3762.      Text produced by the WHOIS command.
  3763.  
  3764. Notify Messages
  3765.      Text of notify messages
  3766.  
  3767. Highlighted Text
  3768.      Text that is configured in the Lists list for AmIRC.
  3769.  
  3770. Server Messages
  3771.      Text that comes from the server.
  3772.  
  3773. CTCP/DCC Messages
  3774.      Text that informs you of an incoming CTCP or DCC request.
  3775.  
  3776. Alt. Background
  3777.      The alternative background colour of the listview(s), indicating
  3778.      that the buffer is scrolled back and you're not seeing new
  3779.      messages being entered until you scroll down.
  3780.  
  3781. Notices
  3782.      Text of notices.
  3783.  
  3784. Join Messages
  3785.      Text when someone enters a channel.
  3786.  
  3787. Kick Messages
  3788.      Text when someone is kicked from a channel.
  3789.  
  3790. CTCP Actions
  3791.      Text produced by a CTCP action.
  3792.  
  3793. Topic related
  3794.      Text that contains any topic action.
  3795.  
  3796. WallOps Text
  3797.      Text meant for all IRC Operators.
  3798.  
  3799. Lists Text
  3800.      Text produced by the LIST command.
  3801.  
  3802. Page/Iconify Buttons
  3803. --------------------
  3804.  
  3805. Here you can specify the colour of the Page (tabs) and Tray Window
  3806. buttons, when their respective channel/chat is not visible, indicating
  3807. a special event.
  3808.  
  3809. New Message
  3810.      Colour of the button when new messages are present.
  3811.  
  3812. Highlight
  3813.      Colour of the button when items have been highlighted.
  3814.  
  3815. AmIRC Configuration
  3816. *******************
  3817.  
  3818. Windows Page
  3819. ============
  3820.  
  3821. Open which windows on startup
  3822. -----------------------------
  3823.  
  3824. In this section you can determine which windows will be opened when
  3825. AmIRC is started. When the gadget behind an item is checked that window
  3826. will be opened.
  3827.  
  3828. Window List?
  3829.      The Window List or Tray Window holds a button for each opened
  3830.      window.
  3831.  
  3832. URL grabber?
  3833.      The URL Grabber window, keeps track of all URL's (or WWW
  3834.      addresses) mentioned on any of the joined channels.
  3835.  
  3836. RAW log?
  3837.      The RAW Log window contains the raw IRC messages.
  3838.  
  3839. DCC send list?
  3840.      The DCC send window can be used to monitor all outgoing DCC
  3841.      traffic.
  3842.  
  3843. Notify list?
  3844.      The Notify window holds all nicks you want to be notified of when
  3845.      they join IRC.
  3846.  
  3847. Info window?
  3848.      The Info window shows all redirected messages and a graphical
  3849.      representation of current lag to the server.
  3850.  
  3851. Privmsg log?
  3852.      The Privmsg displays all messages sent to you with MSG.
  3853.  
  3854. DCC recv list?
  3855.      The DCC receive window can be used to monitor all incoming DCC
  3856.      traffic.
  3857.  
  3858. Other automatic windows
  3859. -----------------------
  3860.  
  3861. 'Invite' window?
  3862.      The 'Invite' window is shown when you are INVITE to a channel.
  3863.  
  3864. AmIRC Configuration
  3865. *******************
  3866.  
  3867. Logging Page
  3868. ============
  3869.  
  3870. Logging
  3871. -------
  3872.  
  3873. In this section the default log file name and log directory can be set.
  3874. You can also specify if you want to log all Channel windows and Dialog
  3875. windows.
  3876.  
  3877. Logfile:
  3878.      This is the file that is used when 'Enable Logging?' item is
  3879.      enabled in the Menus.
  3880.  
  3881. Logfile directory:
  3882.      This is the directory where all individual log files are stored
  3883.      when a Channel or Dialog window is logged.
  3884.  
  3885. Log all Channels?
  3886.      When this item is checked all Channels will be logged.
  3887.  
  3888. Log all Dialog windows?
  3889.      When this item is checked all Dialog windows will be logged.
  3890.  
  3891. Log all URLs?
  3892.      When this item is checked all URLs that appear in the URL Grabber
  3893.      will be logged.
  3894.  
  3895. Filename Templates
  3896. ------------------
  3897.  
  3898. Channel log filename:
  3899.      Here the filename for the channel log files is determined.
  3900.  
  3901. Dialog log filename:
  3902.      Here the filename for the Dialog window log files is determined.
  3903.  
  3904. URL log filename:
  3905.      Here the filename for the URL log file is determined.
  3906.  
  3907.      The gadget at the bottom lists all valid placeholders for the file
  3908.      names.
  3909.  
  3910. AmIRC Configuration
  3911. *******************
  3912.  
  3913. Function Keys Page
  3914. ==================
  3915.  
  3916. Here you may define the Amiga's ten function keys to insert text into
  3917. the input string gadget of AmIRC. By using the keys normally, or with
  3918. the shift or ctrl modifiers, you may define up to 30 text input
  3919. macros that can be used at the press of a key. This is similar to the
  3920. function key macros found on many popular terminal emulation programs.
  3921.  
  3922. A /n at the end of a function key definition will send a <CR> after
  3923. the text. The function key definitions also allow placeholders, similar
  3924. to the Operation.
  3925.  
  3926. AmIRC Configuration
  3927. *******************
  3928.  
  3929. Misc Page
  3930. =========
  3931.  
  3932. CTCP SOUND handling
  3933. -------------------
  3934.  
  3935. Here you may set the directory where AmIRC looks for files requested by
  3936. incoming CTCP requests.
  3937.  
  3938. Directory:
  3939.      Here the directory where AmIRC looks for sounds can be entered.
  3940.  
  3941. Volume:
  3942.      With this slider the playback volume of the sounds can be set from
  3943.      0-64.
  3944.  
  3945. Sound Player
  3946. ------------
  3947.  
  3948. Use external player?
  3949.      When this item is checked AmIRC will use an external player to
  3950.      play the sounds.
  3951.  
  3952. Player command line
  3953.      This is the command that will be executed when AmIRC uses an
  3954.      external player.
  3955.  
  3956. CTCP Flood Control
  3957. ------------------
  3958.  
  3959. Request allowed
  3960.      The number of CTCP requests allowed from a host is a specified
  3961.      time period.
  3962.  
  3963. Flood requests tolerated
  3964.      The number of flood requests allowed before automatically setting
  3965.      an IGNORE on the host.
  3966.  
  3967. Time periods (seconds)
  3968.      The period of time in which the allowed amount of CTCP's can be
  3969.      requested.
  3970.  
  3971. Period extend (seconds)
  3972.      Time added to flood period per CTCP request in case of continued
  3973.      flooding.
  3974.  
  3975. AmIRC's ARexx Port
  3976. ******************
  3977.  
  3978. Overview
  3979. ========
  3980.  
  3981. AmIRC supports a versatile ARexx Port.
  3982.  
  3983.  
  3984.  
  3985. ARGUMENTS:
  3986.  
  3987. None
  3988.  
  3989. DESCRIPTION:
  3990.  
  3991. This script is executed when AmIRC is launched.  It may be used to
  3992. initialise scripts.
  3993.  
  3994. Connected.amirx
  3995. ===============
  3996.  
  3997. ARGUMENTS:
  3998.  
  3999. None
  4000.  
  4001. DESCRIPTION:
  4002.  
  4003. This script is executed once a connection has been established to a
  4004. server.
  4005.  
  4006. Shutdown.amirx
  4007. ==============
  4008.  
  4009. ARGUMENTS:
  4010.  
  4011. None
  4012.  
  4013. DESCRIPTION:
  4014.  
  4015. This script is executed on shutdown of an AmIRC client.  It may be used
  4016. to flush memory.
  4017.  
  4018. Note: It is imperative to change host address in the beginning of the
  4019. script       because the AmIRC arexx port will drop shortly after
  4020. shutdown.amirx       is executed.  EXAMPLE :
  4021.  
  4022.      /* Shutdown.amirx */
  4023.      address REXX
  4024.  
  4025. Custom_CTCP.amirx
  4026. =================
  4027.  
  4028. ARGUMENTS:
  4029.  
  4030. command fromnick destination arguments
  4031.  
  4032. where "destination" is either the destination channel or   your own
  4033. nickname.
  4034.  
  4035. DESCRIPTION:
  4036.  
  4037. This script will be executed for every CTCP command received that is
  4038. not implemented internally into AmIRC.  When this script exists, the
  4039. "Unknown CTCP command ..." line will not be displayed, so include code
  4040. to emulate it.
  4041.  
  4042. EXAMPLE :
  4043.  
  4044. This example shows how to implement a simple page command that plays a
  4045. sound and deiconifies the client.
  4046.  
  4047.      /* Custom_CTCP.amirx */
  4048.      options results
  4049.      parse arg command fromnick destination arguments
  4050.      
  4051.      /* Display unknown CTCP commands */
  4052.      if command ~= 'PAGE' then do
  4053.          'ECHO P=«CTCP» C=5 Unknown "'command'" request from' fromnick'.'
  4054.          exit
  4055.      end
  4056.      /* Ignore if request was sent to a channel */
  4057.      if left(1,destination) ~= '#' then do
  4058.          /* echo a line,deiconify client and play a sample */
  4059.          'ECHO P=«CTCP» C=5' fromnick 'has paged you.'
  4060.          'SHOW'
  4061.          'PLAYSOUND Page.WAV'
  4062.      end
  4063.  
  4064. DCCDone.amirx
  4065. =============
  4066.  
  4067. ARGUMENTS:
  4068.  
  4069. com successcode nick filename
  4070.  
  4071. where :   successcode is 1 for a successful DCC 0 for failed.    com is
  4072. SEND for Outgoing DCC's or RECEIVE for Incoming DCC's.
  4073.  
  4074. DESCRIPTION:
  4075.  
  4076. This script is executed when a DCC is completed/aborted/failed.  It may
  4077. be used to perform automated actions on received files.
  4078.  
  4079. EXAMPLE:
  4080.  
  4081. This script will extract lha/lzx archives to RAM: and play wav's and
  4082. snd's.
  4083.  
  4084.      /* DCCDone.amirx */
  4085.      options results
  4086.      parse arg com successcode nick filename
  4087.      
  4088.      /*Transfer failed/DCC is incoming - abort*/
  4089.      if successcode=0 | com='SEND' then exit
  4090.      
  4091.      /* Obtain 3 - letter extension */
  4092.      ext = upper(right(strip(filename,'B',' "'),4))
  4093.      
  4094.      /*
  4095.      ** #?.wav or #?.snd  will be played in AmIRC
  4096.      ** #?.lha will be extracted to RAM:
  4097.      ** #?.lzx will be extracted to RAM:
  4098.      */
  4099.      Select
  4100.          when ext = '.WAV' | ext = '.SND' then 'PLAYSOUND' filename
  4101.          when ext = '.LHA' then address command 'lha x' filename 'RAM:'
  4102.          when ext = '.lzx' then address command 'lzx x' filename 'RAM:'
  4103.      otherwise
  4104.      end
  4105.  
  4106. HandleFlood.amirx
  4107. =================
  4108.  
  4109. ARGUMENTS:
  4110.  
  4111. :nick!user@host type target :text
  4112.  
  4113. DESCRIPTION:
  4114.  
  4115. If this script exists,it will be called once AmIRC identifies a CTCP
  4116. flood.  It is passed the last flood-line as arguments.  If the script
  4117. does not exist, the internal AmIRC function will be used.
  4118.  
  4119. EXAMPLE :
  4120.  
  4121.      This example will effectively emulate the internal AmIRC flood
  4122.      protection.  One may improve on it.
  4123.      
  4124.      /* Handleflood.amirx */
  4125.      options results
  4126.      parse arg last
  4127.      "parseline" last
  4128.      
  4129.      parse value last.prefix WITH nick'!'user''host
  4130.      
  4131.      'SAY /IGNORE *!*'host 'CTCP'
  4132.      "ECHO P=FloodProt Flood from" nick "defused."
  4133.  
  4134. SAY
  4135. ===
  4136.  
  4137. Usage:
  4138.      SAY TEXT/F
  4139.  
  4140. DESCRIPTION:
  4141.  
  4142. Treats TEXT just like it has been entered in the string gadget of the
  4143. current window.
  4144.  
  4145. EXAMPLES:
  4146.  
  4147.      'say /JOIN #Amigager'
  4148.  
  4149. RELATED TOPICS: See RX_ECHO.
  4150.  
  4151. ISCONNECTED
  4152. ===========
  4153.  
  4154. Usage:
  4155.      ISCONNECTED
  4156.  
  4157. DESCRIPTION:
  4158.  
  4159. Checks whether a connection is currently established. Returns RC 0 if
  4160. the link is up, RC 5 otherwise.
  4161.  
  4162. EXAMPLES:
  4163.  
  4164.      "ISCONNECTED";"ECHO" rc
  4165.  
  4166. RELATED TOPICS:
  4167.  
  4168. GETMYNICK
  4169. =========
  4170.  
  4171. Usage:
  4172.      GETMYNICK
  4173.  
  4174. DESCRIPTION:
  4175.  
  4176. Returns your current nickname.
  4177.  
  4178. EXAMPLES:
  4179.  
  4180.      "GETMYNICK";"ECHO" result
  4181.  
  4182. RELATED TOPICS: See RX_GETSERVERNAME.
  4183.  
  4184. GETSERVERNAME
  4185. =============
  4186.  
  4187. Usage:
  4188.      GETSERVERNAME
  4189.  
  4190. DESCRIPTION:
  4191.  
  4192. Returns the name of the IRC server you are currently connected to.
  4193.  
  4194. EXAMPLES:
  4195.  
  4196.      "GETSERVERNAME";"ECHO" result
  4197.  
  4198. RELATED TOPICS: See RX_GETMYNICK.
  4199.  
  4200. USERHOST
  4201. ========
  4202.  
  4203. Usage:
  4204.      USERHOST NICK/A
  4205.  
  4206. DESCRIPTION:
  4207.  
  4208. Returns the userhost specification belonging to NICK.  AMIRC keeps an
  4209. internal list of the userhosts of every nick that occurred yet. You can
  4210. query this database with this command.  Note however that it is
  4211. possible that the userhost isn't in the database yet; this command will
  4212. not query the server then, but simply return an error.
  4213.  
  4214. EXAMPLES:
  4215.  
  4216.      "USERHOST Olli";"ECHO" result
  4217.  
  4218. RELATED TOPICS: See RX_GETMYNICK.
  4219.  
  4220. ECHO
  4221. ====
  4222.  
  4223. Usage:
  4224.      ECHO P=PREFIX/K,C=COL/K/N,TEXT/F/A
  4225.  
  4226. DESCRIPTION:
  4227.  
  4228. Sends text to the listview.  With P=Text you can set the prefix which
  4229. will be put in the Prefix part of the echo.  With C=Colour you can set
  4230. any of the colours set in the AmIRC configuration. The colours you can
  4231. use are :
  4232. C=0 : Normal Text
  4233. C=1 : Highlighted Text
  4234. C=2 : Private Messages
  4235. C=3 : Server Messages
  4236. C=4 : Mode Changes
  4237. C=5 : CTCP/DCC Messages
  4238. BUGS:
  4239.  
  4240. AmigaDOS Readargs() has a small bug.
  4241.  
  4242. If you do "ECHO P" or "ECHO P=Prefix P is a letter" or "ECHO C" or
  4243. "ECHO C=1 C is a letter"
  4244.  
  4245. AmIRC will not display anything.  To cure this enter the template in
  4246. full like: "ECHO TEXT=P..."
  4247.  
  4248. EXAMPLES:
  4249.  
  4250.      "ECHO P=Kewlja C=3 This is echo test"
  4251.  
  4252. RAW
  4253. ===
  4254.  
  4255. Usage:
  4256.      RAW TEXT/F
  4257.  
  4258. DESCRIPTION:
  4259.  
  4260. Sends text to the server in raw format.
  4261.  
  4262. EXAMPLES:
  4263.  
  4264.      "RAW PRIVMSG phalanx :heya! what's happening?"
  4265.  
  4266. GETWINNUM
  4267. =========
  4268.  
  4269. Usage:
  4270.      GETWINNUM CHANNEL/A
  4271.  
  4272. DESCRIPTION:
  4273.  
  4274. Returns the window number for the specified channel.
  4275.  
  4276. EXAMPLES:
  4277.  
  4278.      options results;"getwinnum CHANNEL=#amiga";"ECHO" result
  4279.  
  4280. GETCHANNEL
  4281. ==========
  4282.  
  4283. Usage:
  4284.      GETCHANNEL WINNUM/N
  4285.  
  4286. DESCRIPTION:
  4287.  
  4288. Returns the name of the channel currently active in the format:
  4289. "#channel."
  4290.  
  4291. If the WINNUM argument is given , the channel for that window is
  4292. returned.
  4293.  
  4294. EXAMPLES:
  4295.  
  4296.      options results;"getchannel";"ECHO" result
  4297.  
  4298.      options results;"getchannel WINNUM=1";"ECHO" result
  4299.  
  4300. RELATED TOPICS: See RX_CHANNELS, RX_GETWINNUM.
  4301.  
  4302. CHANNELS
  4303. ========
  4304.  
  4305. Usage:
  4306.      CHANNELS
  4307.  
  4308. DESCRIPTION:
  4309.  
  4310. Returns a list of channels currently joined in the format: "#channel1
  4311. #channel2 etc."
  4312.  
  4313. EXAMPLES:
  4314.  
  4315.      options results;"channels";"ECHO" result
  4316.  
  4317. GETDCC
  4318. ======
  4319.  
  4320. Usage:
  4321.      GETDCC
  4322.  
  4323. DESCRIPTION:
  4324.  
  4325. Returns status of DCC Send, Receive and Chat to stem variables.
  4326. Remember that the values set are the current ones. If your script will
  4327. delay for a minute or so the values for cps or state will possible
  4328. change. To refresh them, call GETDCC again.
  4329.  
  4330. The status is returned to three stems:
  4331.  
  4332.      dcc.send.#    : DCC Send
  4333.      dcc.send.0 holds number of entries.
  4334.      dcc.send.# is composed of :
  4335.      
  4336.      nick moveflag hostname state length cps filename
  4337.      
  4338.      * moveflag reflects if this DCC is MOVE or SEND
  4339.      state can be :
  4340.      
  4341.      0 : Waiting
  4342.      1 : Aborted
  4343.      2 : Sending
  4344.      3 : Complete
  4345.      4 : Failed
  4346.      5 : No Socket
  4347.      6 : No File
  4348.      7 : ReadError
  4349.      8 : Calculating Checksum
  4350.      So to see if a dcc is active, check if state=2|state=8
  4351.      
  4352.      dcc.receive.#    : DCC Receive
  4353.      dcc.receive.0 holds number of entries.
  4354.      dcc.receive.# is composed of :
  4355.      
  4356.      nick moveflag hostname state length cps filename
  4357.      
  4358.      * moveflag reflects if this DCC is MOVE or SEND
  4359.      
  4360.      state can be :
  4361.      
  4362.      0 : Waiting
  4363.      1 : Connecting
  4364.      2 : Receiving
  4365.      3 : Complete
  4366.      4 : Failed
  4367.      5 : Unable to connect
  4368.      6 : Aborted
  4369.      7 : No Socket
  4370.      8 : Unknown Host
  4371.      9 : No File
  4372.      10: Disk Write Error
  4373.      
  4374.      So to see if a dcc is active, check if state=1|state=2
  4375.      
  4376.      EXAMPLE :
  4377.      
  4378.      The following loop goes through the list of dcc receives (if there
  4379.      are ones active) and parses each entry.
  4380.      
  4381.      "GETDCC"
  4382.      if dcc.receive.0>0 THEN DO i=1 TO dcc.receive.0
  4383.          parse value dcc.receive.i WITH nick moveflag hostname state length cps filename .
  4384.          /*process*/
  4385.      end
  4386.      
  4387.      dcc.chat.#    : DCC Chat
  4388.      dcc.chat.0 holds number of entries.
  4389.      dcc.chat.# is composed of :
  4390.      
  4391.      nick state hostname
  4392.      
  4393.      state can be :
  4394.      
  4395.      0 : Waiting
  4396.      1 : Connecting
  4397.      2 : Connected
  4398.      3 : Waiting for
  4399.      4 : Closed
  4400.      5 : Unable to connect
  4401.      6 : No Socket
  4402.      7 : Aborted
  4403.      
  4404.      So to see if a dcc is active, check if state=1
  4405.      
  4406.      EXAMPLE :
  4407.      
  4408.      The following loop goes through the list of dcc chats (if there
  4409.      are ones active) and parses each entry.
  4410.      
  4411.      "GETDCC"
  4412.      if dcc.chat.0>0 THEN DO i=1 TO dcc.chat.0
  4413.          parse value dcc.receive.i WITH nick state hostname .
  4414.          /*process*/
  4415.      end
  4416.  
  4417. GETSELECTEDUSER
  4418. ===============
  4419.  
  4420. Usage:
  4421.      GETSELECTEDUSER WINNUM/N,CHANNEL/K
  4422.  
  4423. DESCRIPTION:
  4424.  
  4425. Returns the Nick the user highlighted in the userlist window.
  4426.  
  4427. If the WINNUM argument is specified, the selected user in that window
  4428. will be returned.  If the CHANNEL argument is specified, the selected
  4429. user in that channel will be returned.
  4430.  
  4431. EXAMPLES:
  4432.  
  4433.      options results;"getselecteduser";"ECHO" result
  4434.  
  4435.      options results;"getselecteduser WINNUM=1";"ECHO" result
  4436.  
  4437.      options results;"getselecteduser CHANNEL=#amiga";"ECHO" result
  4438.  
  4439. RELATED TOPICS: See RX_GETUSER, RX_GETUSERS, RX_GETWINNUM.
  4440.  
  4441. GETUSER
  4442. =======
  4443.  
  4444. Usage
  4445.      GETUSER USER/N/A,WINNUM/N,CHANNEL/K
  4446.  
  4447. DESCRIPTION:
  4448.  
  4449. Returns the nick of the user number given on the active channel
  4450. userlist.
  4451.  
  4452. If the WINNUM argument is specified, the nick in that window will be
  4453. returned.  If the CHANNEL argument is specified, the nick in that
  4454. channel will be returned.
  4455.  
  4456. Keep in mind, the userlist starts from 0!
  4457.  
  4458. EXAMPLES:
  4459.  
  4460.      options results; "getuser 0"; "ECHO" result
  4461.  
  4462.      options results; "getuser 0 WINNUM=1"; "ECHO" result
  4463.  
  4464.      options results; "getuser 0 CHANNEL=#amiga"; "ECHO" result
  4465.  
  4466. RELATED TOPICS: See RX_GETSELECTEDUSER, RX_GETUSERS, RX_GETWINNUM.
  4467.  
  4468. GETUSERS
  4469. ========
  4470.  
  4471. Usage
  4472.      GETUSERS WINNUM/N,CHANNEL/K
  4473.  
  4474. DESCRIPTION:
  4475.  
  4476. Returns a string containing the list of users on the active channel.
  4477.  
  4478. The user list is time-sorted and every user is appended the "@" char
  4479. for Ops and "+" char for voice. This is effectively a copy from /names
  4480. output.  This will look like : @Nick1 Nick2 +Nick3 Nick4 Nick1 is
  4481. opped, and joined the channel first (is first in the list).  Nick3 is
  4482. voiced.  Nick4 joined the channel last.
  4483.  
  4484. If the WINNUM argument is specified, the users in that window will be
  4485. returned.  If the CHANNEL argument is specified, the users in that
  4486. channel will be returned.
  4487.  
  4488. EXAMPLES:
  4489.  
  4490.      options results; "getusers"; "ECHO" result
  4491.  
  4492.      options results; "getusers WINNUM=1"; "ECHO" result
  4493.  
  4494.      options results; "getusers CHANNEL=#amiga"; "ECHO" result
  4495.  
  4496. RELATED TOPICS: See RX_GETUSER, RX_GETSELECTEDUSER.
  4497.  
  4498. GETUSERSTATE
  4499. ============
  4500.  
  4501. Usage
  4502.      GETUSERSTATE USER/N/A,WINNUM/N,CHANNEL/K
  4503.  
  4504. DESCRIPTION:
  4505.  
  4506. Returns the status of user "num" on the active channel.
  4507.      RC=0 User is on-line, but has no special status.
  4508.  
  4509.      RC=1 User is Channel Operator.
  4510.  
  4511.      RC=2 User is on-line and has been "Voiced".
  4512.  
  4513.      RC=5 User # not in the userlist.
  4514.  
  4515. If the WINNUM argument is specified, the status for the user in that
  4516. window will be returned.  If the CHANNEL argument is specified, the
  4517. status for the user in that channel will be returned.
  4518.  
  4519. EXAMPLES:
  4520.  
  4521.      options results; "getuserstate 0"; "ECHO" rc
  4522.  
  4523.      options results; "getuserstate 0 WINNUM=1"; "ECHO" rc
  4524.  
  4525.      options results; "getuserstate 1 CHANNEL=#amiga"; "ECHO" rc
  4526.  
  4527. GETLINE
  4528. =======
  4529.  
  4530. Usage
  4531.      GETLINE
  4532.  
  4533. DESCRIPTION:
  4534.  
  4535. Waits for a line from the server and returns the following stem
  4536. variables;.
  4537.      LINE        = The entire, unparsed, line received.
  4538.  
  4539.      LINE.PREFIX = The Nick and user@host.
  4540.  
  4541.      LINE.COMMAND= The MSG Type.
  4542.  
  4543.      LINE.DEST   = The channel the message was written to.
  4544.  
  4545.      LINE.REST   = The message text.
  4546. EXAMPLES:
  4547.  
  4548.      options results
  4549.      
  4550.      "getline"
  4551.      
  4552.      text=line prefix=line.prefix comm=line.command dest=line.dest
  4553.      rest=line.rest
  4554.      
  4555.      "ECHO" text prefix comm dest rest
  4556.  
  4557. RELATED TOPICS: See RX_PARSELINE, RX_GETLASTLINE.
  4558.  
  4559. GETLINECOUNT
  4560. ============
  4561.  
  4562. Usage
  4563.      GETLINECOUNT
  4564.  
  4565. DESCRIPTION:
  4566.  
  4567. Returns the number of lines in the channel buffer for the active window
  4568. channel.
  4569.  
  4570. EXAMPLES:
  4571.  
  4572.      options results; "getlinecount"; "ECHO" result
  4573.  
  4574. RELATED TOPICS: See RX_GETLINE.
  4575.  
  4576. GETLASTLINE
  4577. ===========
  4578.  
  4579. Usage
  4580.      GETLASTLINE
  4581.  
  4582. DESCRIPTION:
  4583.  
  4584. Returns the last private message received in the format;.
  4585. :nick!~user@host Messagetype Nick :message text.
  4586.  
  4587. EXAMPLES:
  4588.  
  4589.      options results; "getlastline"; "ECHO" result
  4590.  
  4591. RELATED TOPICS: See RX_PARSELINE, RX_GETLINE.
  4592.  
  4593. GETAWAYSTATE
  4594. ============
  4595.  
  4596. Usage
  4597.      GETAWAYSTATE
  4598.  
  4599. DESCRIPTION:
  4600.  
  4601. Returns your away status.
  4602.      rc=0 Not away.
  4603.  
  4604.      rc=5 Away.
  4605. EXAMPLES:
  4606.  
  4607.      options results; "getawaystate"; "ECHO" rc
  4608.  
  4609. GETVERSION
  4610. ==========
  4611.  
  4612. Usage
  4613.      GETUSERS
  4614.  
  4615. DESCRIPTION:
  4616.  
  4617. Returns the Version number of AmIRC.
  4618.  
  4619. EXAMPLES:
  4620.  
  4621.      options results; "getversion"; "ECHO" result
  4622.  
  4623. GETCTCPSOUNDDIR
  4624. ===============
  4625.  
  4626. Usage
  4627.      GETCTCPSOUNDDIR
  4628.  
  4629. DESCRIPTION:
  4630.  
  4631. Returns the path to the sounds played with ctcp sound.
  4632.  
  4633. EXAMPLES:
  4634.  
  4635.      options results; "GETCTCPSOUNDDIR" ; "ECHO" result
  4636.  
  4637. GETDCCRECEIVEDIR
  4638. ================
  4639.  
  4640. Usage
  4641.      GETDCCRECEIVEDIR
  4642.  
  4643. DESCRIPTION:
  4644.  
  4645. Returns the path of the dcc receive directory.
  4646.  
  4647. EXAMPLES:
  4648.  
  4649.      options results; "GETDCCRECEIVEDIR" ; "ECHO" result
  4650.  
  4651. MATCHUSERHOST
  4652. =============
  4653.  
  4654. Usage
  4655.      MATCHUSERHOST USERHOST/A,PATTERN/A
  4656.  
  4657. DESCRIPTION:
  4658.  
  4659. Matches userhost with pattern and sets rc to 0 if there is no match and
  4660. rc to 1 if there is a match.  USERHOST must be a real host like
  4661. nick!user@hostname and not a pattern.  PATTERN may hold special
  4662. characters like "*" and "?" such as ni*!use?@ho?tna*.
  4663.  
  4664. EXAMPLES:
  4665.  
  4666.      options results
  4667.      "MATCHUSERHOST Joe!Joeshmoe@ppp100.net.il *!*@*.net.il"
  4668.      "ECHO" rc
  4669.  
  4670. PLAYSOUND
  4671. =========
  4672.  
  4673. Usage
  4674.      PLAYSOUND FILENAME,EVENT/K/N
  4675.  
  4676. DESCRIPTION:
  4677.  
  4678. This command will play a sound via AmIRC.  It may play a sound-file if
  4679. you give it a filename.  You don't have to give a complete file name,
  4680. you can give one that is in the sounds directory.  You may also play
  4681. the sound set for one of the events by specifying the EVENT argument.
  4682.  
  4683. EXAMPLES:
  4684.  
  4685.      "PLAYSOUND Hello.WAV"
  4686.  
  4687.      "PLAYSOUND EVENT=1"
  4688.  
  4689. PARSELINE
  4690. =========
  4691.  
  4692. Usage
  4693.      PARSELINE LINE/F/A
  4694.  
  4695. DESCRIPTION:
  4696.  
  4697. Parses the line specified and returns the following stem variables;
  4698.      LINE        = The entire, unparsed, line received.
  4699.  
  4700.      LINE.PREFIX = The Nick and user@host
  4701.  
  4702.      LINE.COMMAND= The MSG Type
  4703.  
  4704.      LINE.DEST   = The channel the message was written to.
  4705.  
  4706.      LINE.REST   = The message text.
  4707. EXAMPLES:
  4708.  
  4709.      options results
  4710.      
  4711.      "getlastline"
  4712.      last=result
  4713.      "parseline" last
  4714.      
  4715.      text=line
  4716.      prefix=line.prefix
  4717.      comm=line.command
  4718.      dest=line.dest
  4719.      rest=line.rest
  4720.      
  4721.      "ECHO" text prefix comm dest rest
  4722.  
  4723. RELATED TOPICS: See RX_GETLINE, RX_GETLASTLINE.
  4724.  
  4725. How to Get Help & Updates
  4726. *************************
  4727.  
  4728. Support
  4729. =======
  4730.  
  4731.     AmIRC Support Mailing List
  4732.  
  4733.      To keep up to date on AmIRC improvements or to get answers to AmIRC
  4734.      problems, join the AmIRC support mailing list by sending email to:
  4735.      
  4736.      <AmIRC-Request@vapor.com>
  4737.      
  4738.      with the text ADD in the body.
  4739.      
  4740.      AmIRC FTP Support Site
  4741.      
  4742.      For AmIRC Updates & Patches, ftp to:
  4743.      
  4744.      ftp.vapor.com, /pub/amirc/
  4745.      
  4746.      AmIRC Support on the World Wide Web
  4747.      
  4748.      Or, Alternatively, visit the Vapor WWW Site at:
  4749.      
  4750.      http://www.vapor.com/
  4751.  
  4752. Index
  4753. *****
  4754.  
  4755.  
  4756.  
  4757.  ? command                              ?
  4758.  About AmIRC                            About AmIRC
  4759.  Actions Options                        Actions
  4760.  ADMIN command                          ADMIN
  4761.  Administrator, Showing                 ADMIN
  4762.  ALIAS command                          ALIAS
  4763.  Aliases, setting up                    Lists
  4764.  AmIRC                                  About AmIRC
  4765.  AmIRC Menu                             AmIRC
  4766.  AmIRC Support                          AmIRC Support
  4767.  ARexx Menu                             Rexx
  4768.  ARexx Reference                        ARexx
  4769.  Arexx, Using                           RX
  4770.  Auto-Inviting, Adding                  INVADD
  4771.  Auto-Inviting, Listing                 INVLIST
  4772.  Auto-Inviting, Removing                INVDEL
  4773.  AWAY command                           AWAY
  4774.  AWAY, Resetting                        BACK
  4775.  AWAY, Setting                          AWAY
  4776.  BACK command                           BACK
  4777.  BAN command                            BAN
  4778.  Ban exception(s), Adding               EXCADD
  4779.  Ban exception(s), Listing              EXCLIST
  4780.  Ban exception(s), Removing             EXCDEL
  4781.  Ban, Listing                           BANLIST
  4782.  Ban, Removing                          BANDEL
  4783.  BANDEL command                         BANDEL
  4784.  BANLIST command                        BANLIST
  4785.  Buffer, Clearing                       CLEAR
  4786.  Buffer, Searching                      LASTLOG
  4787.  CHANNEL command                        CHANNEL
  4788.  Channel Op, Removing                   DEOP
  4789.  Channel, Joining/Creating              CHANNEL
  4790.  Channel, Joining/Creating              JOIN
  4791.  Channel, Leaving                       LEAVE
  4792.  Channel, Leaving                       PART
  4793.  Channels, Listing                      LIST
  4794.  ChanOp, Setting                        OP
  4795.  Chat Window, Logging                   LOG
  4796.  CLEAR command                          CLEAR
  4797.  Colourcodes                            COLOURCODES
  4798.  Colours, Changing text                 COLOURCODES
  4799.  Command, Renaming                      ALIAS
  4800.  Commands                               Commands
  4801.  Configuration Options                  AmIRC Setup
  4802.  Configuration with MUI                 MUI Preferences
  4803.  Configuring AmIRC                      Configuration
  4804.  CONNECT command                        CONNECT
  4805.  Connecting to an IRC server            Connecting
  4806.  Contents, Table of                     Top
  4807.  Copyright Information                  Copyright
  4808.  CTCP Action, Sending                   ME
  4809.  CTCP command                           CTCP
  4810.  CTCP command, Sending                  CTCP
  4811.  CTCP Ping, Sending                     PING
  4812.  CTCP Sound Settings                    Misc
  4813.  CYCLE command                          CYCLE
  4814.  CYCLE command, Sending                 CYCLE
  4815.  DCC command                            DCC
  4816.  DCC command, Sending                   DCC
  4817.  DEOP command                           DEOP
  4818.  DESCRIBE command                       DESCRIBE
  4819.  Events Options                         Events
  4820.  EXCADD command                         EXCADD
  4821.  EXCDEL command                         EXCDEL
  4822.  EXCLIST command                        EXCLIST
  4823.  FAKE command                           FAKE
  4824.  Features                               Features
  4825.  FINDHOST command                       FINDHOST
  4826.  Function Keys, Setting up              FKeys
  4827.  GLINE command                          GLINE
  4828.  Global KLine, Showing                  GLINE
  4829.  HELP command                           HELP
  4830.  Help, Getting                          HELP
  4831.  Help, Getting                          ?
  4832.  HIGHLITE command                       HIGHLITE
  4833.  Hilighting certain text                Lists
  4834.  HILITE command                         HILITE
  4835.  IGNORE command                         IGNORE
  4836.  Ignoring Users                         Lists
  4837.  INFO command                           INFO
  4838.  Installing AmIRC                       Installation
  4839.  Interface Options                      Interface
  4840.  INVADD command                         INVADD
  4841.  INVDEL command                         INVDEL
  4842.  INVITE command                         INVITE
  4843.  INVLIST command                        INVLIST
  4844.  IRC Names, Showing                     NAMES
  4845.  IRC Terminology                        IRC Terms
  4846.  IRC, Quitting                          QUIT
  4847.  IRCNAME command                        IRCNAME
  4848.  IRCop, Setting                         OPER
  4849.  ISON command                           ISON
  4850.  JOIN command                           JOIN
  4851.  KICK command                           KICK
  4852.  KICK command                           QKICK
  4853.  KICKBAN command                        QKICKBAN
  4854.  KICKBAN command                        KICKBAN
  4855.  KILL command                           KILL
  4856.  LASTLOG command                        LASTLOG
  4857.  LEAVE command                          LEAVE
  4858.  LINKS command                          LINKS
  4859.  LIST command                           LIST
  4860.  LOAD command                           LOAD
  4861.  LOG command                            LOG
  4862.  Logging Settings                       Logging
  4863.  LUSERS command                         LUSERS
  4864.  M command                              M
  4865.  MAP command                            MAP
  4866.  ME command                             ME
  4867.  Menus                                  Menus
  4868.  Messages options                       Messages
  4869.  MODE command                           MODE
  4870.  Modes, Changing                        MODE
  4871.  MOTD command                           MOTD
  4872.  MOTD, Showing                          MOTD
  4873.  MSG command                            MSG
  4874.  MUI Configuration                      MUI Preferences
  4875.  NAMES command                          NAMES
  4876.  NICK command                           NICK
  4877.  Nickname, Changing                     NICK
  4878.  Nickname, Changing                     IRCNAME
  4879.  Nickname, Setting                      NICK
  4880.  NOTE command                           NOTE
  4881.  NOTICE command                         NOTICE
  4882.  Notice, Sending                        NOTICE
  4883.  NOTIFY command                         NOTIFY
  4884.  OP command                             OP
  4885.  OPER command                           OPER
  4886.  Operating AmIRC                        Operation
  4887.  Operators, Sending text to             WALLOPS
  4888.  PART command                           PART
  4889.  Pattern matching of users              WHO
  4890.  PING command                           PING
  4891.  Plugin, Loading                        LOAD
  4892.  Plugin, Reloading                      RELOAD
  4893.  Plugin, Unloading                      UNLOAD
  4894.  Plugins Menu                           Plugins
  4895.  PrivMsg, Sending                       RMSG
  4896.  PrivMsg, Sending                       M
  4897.  PrivMsg, Sending                       MSG
  4898.  QUERY command                          QUERY
  4899.  Query window, Opening                  QUERY
  4900.  QUIT command                           QUIT
  4901.  QUOTE command                          QUOTE
  4902.  RAW command                            RAW
  4903.  Raw text, Sending                      QUOTE
  4904.  Raw text, Sending                      RAW
  4905.  RECONNECT command                      RECONNECT
  4906.  Reconnecting                           RECONNECT
  4907.  Registration                           Registration
  4908.  REHASH command                         REHASH
  4909.  RELOAD command                         RELOAD
  4910.  Requirements for running AmIRC         Requirements
  4911.  RESTART command                        RESTART
  4912.  RMSG command                           RMSG
  4913.  RX command                             RX
  4914.  RXRETURN command                       RXRETURN
  4915.  SERVER command                         SERVER
  4916.  Server data, Fake                      FAKE
  4917.  Server Info, Getting                   INFO
  4918.  Server Links, Showing                  LINKS
  4919.  Server Map, Showing                    MAP
  4920.  Server, (Re)connecting                 CONNECT
  4921.  Server, Connecting                     SERVER
  4922.  Server, Quitting                       SQUIT
  4923.  Server, Resetting                      REHASH
  4924.  Server, Restarting                     RESTART
  4925.  Server, Tracing                        TRACE
  4926.  Settings Menu                          Settings
  4927.  Settings menu: Actions                 Actions
  4928.  Settings Menu: Colors                  Colors
  4929.  Settings Menu: Events                  Events
  4930.  Settings Menu: Interface               Interface
  4931.  Settings Menu: Lists                   Lists
  4932.  Settings Menu: Messages                Messages
  4933.  SILENCE command                        SILENCE
  4934.  SOUND command                          SOUND
  4935.  Sounds, Sending                        SOUND
  4936.  SQUIT command                          SQUIT
  4937.  STATS command                          STATS
  4938.  Stats, Showing                         STATS
  4939.  SUMMON command                         SUMMON
  4940.  Support for AmIRC users                AmIRC Support
  4941.  Text Colors                            Colors
  4942.  Text, Highlighting                     HIGHLITE
  4943.  Text, Highlighting                     HILITE
  4944.  Text, Unhighlighting                   UNHIGHLITE
  4945.  Text, Unhighlighting                   UNHILITE
  4946.  TIME command                           TIME
  4947.  Time, Getting server's                 TIME
  4948.  TOPIC command                          TOPIC
  4949.  Topic, Changing                        TOPIC
  4950.  TRACE command                          TRACE
  4951.  UMODE command                          UMODE
  4952.  UNHIGHLITE command                     UNHIGHLITE
  4953.  UNHILITE command                       UNHILITE
  4954.  UNIGNORE command                       UNIGNORE
  4955.  UNLOAD command                         UNLOAD
  4956.  UNVOICE command                        UNVOICE
  4957.  UPING command                          UPING
  4958.  User IsOn, Checking if                 ISON
  4959.  User Modes Menu                        User Modes
  4960.  User's, Finding more info on           WHOIS
  4961.  User, Banning                          BAN
  4962.  User, Describing to                    DESCRIBE
  4963.  User, Disconnecting                    KILL
  4964.  User, Giving Voice                     VOICE
  4965.  User, Ignoring                         IGNORE
  4966.  User, Inviting                         INVITE
  4967.  User, Kicking                          KICK
  4968.  User, Kicking                          QKICK
  4969.  User, Kicking/Banning                  QKICKBAN
  4970.  User, Kicking/Banning                  KICKBAN
  4971.  User, Notifying                        NOTIFY
  4972.  User, Removing Ignore                  UNIGNORE
  4973.  User, Removing Voice                   UNVOICE
  4974.  User, Silencing                        SILENCE
  4975.  User, Summon                           SUMMON
  4976.  User, Tracing                          TRACE
  4977.  USERHOST command                       USERHOST
  4978.  Userhost, Finding                      USERHOST
  4979.  USERS command                          USERS
  4980.  Users Info, Showing                    LUSERS
  4981.  Users, Finding                         FINDHOST
  4982.  Users, Listing                         USERS
  4983.  VERSION command                        VERSION
  4984.  Version, Server's software             VERSION
  4985.  Version, User's client                 VERSION
  4986.  VOICE command                          VOICE
  4987.  WALLOPS command                        WALLOPS
  4988.  What's new?                            What's new?
  4989.  WHO command                            WHO
  4990.  Who Was User                           WHOWAS
  4991.  WHOIS command                          WHOIS
  4992.  WHOWAS command                         WHOWAS
  4993.  Windows Menu                           Windows
  4994.  Windows Settings                       Window
  4995.  
  4996.